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Preface 


This manual describes the syntax and features of the User Interface 
Language (UIL), a specification language for describing the initial state of 
a user interface for a VMS DECwindows application. 


Intended Audience 


This manual is intended for application programmers who are familiar 
with the routines in the XUI Toolkit and who know at least one high-level 
programming language. 


Document Structure 
This manual includes four chapters and two appendixes. 


¢ Chapter 1 introduces UIL and explains the advantages UIL offers 
over other methods for creating user interfaces for VMS DECwindows 
applications. 


¢ Chapter 2 describes the syntax of low-level elements of UIL, including 
names, keywords, literals, functions, supported character sets for 
string literals, and compile-time value expressions. 


¢ Chapter 3 describes the syntax of UIL module components (module 
header, value, procedure, identifier, and object declarations; 
arguments, controls, and callbacks lists) and describes additional 
features of UIL, including support for constraint widgets, symbolic 
references to widget identifiers, and UIL identifiers. 


¢ Chapter 4 explains how to use the UIL compiler, including UIL 
command line qualifiers, and how to interpret compiler diagnostics. 


e Appendix A lists diagnostic messages and includes corrective action. 


e Appendix B lists the UIL built-in tables. For each object in the 
XUI Toolkit, this appendix lists the callback reasons, children, and 
arguments supported by the UIL compiler. The data type and default 
value are given for each argument. This appendix also includes an 
alphabetical listing of the arguments with their MIT C and VAX 
binding names. 





Associated Documenis 


The following manuals contain information on the XUI Resource Manager 
(DRM) run-time routines (which read the output of the UIL compiler) and 
on using UIL and DRM together to create the interface for a DECwindows 
application. 


¢ VMS DECwindows Guide to Application Programming 
¢ VMS DECwindows Toolkit Routines Reference Manual 


Preface 


The following documents include information that may be helpful i in using 
UIL to specify a user interface. - 


e XUI Style Guide 


¢ VMS DECwindows Xlib Programming Volume 
¢ VMS DECwindows Xlib Routines Reference Manual © 





Conventions 


The following conventions are used in this manual: 


mouse 


Ctri/x 


{} 


red ink 


xvi 


The term mouse is used to refer to any pointing 
device, such as a mouse, a puck, or a stylus. 


A sequence such as Ctri/x indicates that you must 
hold down the key labeled Ctri while you press 
another key or a pointing device button. 


In examples, a key name is shown enclosed in a box 
to indicate that you press a key on the keyboard. (In 
text, a key name is not enclosed in a box.) . 


In examples, a horizontal ellipsis indicates one of the 
following possibilities: 


* Additional optional arguments in a statement 
have been omitted. | 

* The preceding item or items can be repeated one 
or more times. 

¢ Additional parameters, values, or other 
information can be entered. 


A vertical ellipsis indicates the omission of items from 
a code example or command format; the items are 
omitted because they are not important to the topic 
being discussed. 


In format descriptions, parentheses indicate that, if 
you choose more than one option, you must enclose 
the choices in parentheses. 


In format descriptions, brackets indicate that whatever 
is enclosed within the brackets is optional; you can 
select none, one, or all of the choices. (Brackets are 
not, however, optional in the syntax of a directory 
name in a file specification or in the syntax of a 
substring specification in an assignment statement.) 


In format descriptions, braces surround a required 
choice of options; you must choose one of the options 
listed. 


Red ink indicates information that you must enter from | 
the keyboard or a screen object that you must choose 
or click on. 


For online versions of the book, user peu is 3 shown | in 
bold. 


boldface text 


italic text 


UPPERCASE TEXT 


numbers 


Preface 


Boldface text represents the introduction of a new 
term or the name of an argument, an attribute, or a 
reason. 


Boldface text is also used to show user input in online 
versions of the book. 


Italic text represents information that can vary 
in system messages (for example, Internal error 
numbepr). 


Uppercase letters indicate that you must enter a 
command (for example, enter OPEN/READ), or they 
indicate the name of a routine, the name of a file, the 
name of a file protection code, or the abbreviation for 
a system privilege. 

Hyphens in coding examples indicate that additional 
arguments to the request are provided on the line that 
follows. 


Unless otherwise noted, all numbers in the text are 
assumed to be decimal. Nondecimal radixes—binary, 
octal, or hexadecimal—are explicitly indicated. 


Syntax of the UIL language elements and the UIL module components 
in this manual are described using the following extended Backus-Naur 





Form (BNF) notation: 
Notation Description 
VALUE Keywords are shown in uppercase letters. 


k_main_menu 


[MANAGED | UNMANAGED] 


{widget_name} 


Lowercase words represent either user- 
supplied names and constants or complete 
syntactical entries defined elsewhere in the 
syntax. 


Brackets enclose an optional part of the 
syntax. 


Braces enclose a required part of the syntax. 


EXPORTED|PRIVATE|IMPORTED __ A vertical bar indicates mutually exclusive 


list_declaration... 


wi 


Xxx_name 


alternatives. 


Ellipsis (...) indicates that the clause can be 
repeated either zero or more times if it is 
optional, or one or more times if it is required. 


Punctuation that is part of the syntax is 
enclosed in quotation marks. 


A name in this form must correspond to a valid 
UIL name. 
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1.1 


1.2 


Introduction to the User Interface Language 


Overview of UIL 


This chapter introduces the User Interface Language (UIL) and explains 
the advantages UIL offers over using XUI Toolkit routines to create user 
interfaces for VMS DECwindows applications. 





UIL is a specification language for describing the initial state of a user 
interface for a DECwindows application. The specification describes the 
objects (menus, dialogs, labels, push buttons, and so on) used in the 
interface and specifies the routines to be called when the interface changes 
state as a result of user interaction. 


The UIL compiler translates the UIL code into a User Interface Definition 
(UID) file. You include XUI Resource Manager (DRM) routine calls in your 
application program, which allow access to the UID file. During execution 
of the application, DRM builds argument lists and makes the necessary 
calls to the widget creation routines in order to create the user interface. 
UIL and DRM are components of the XUI Toolkit. 


Using UIL, you can specify the following: 

e Objects (widgets and gadgets) that comprise your interface 

e Arguments (attributes) of the widgets and gadgets you specify 
e Callback routines for each widget 

e Hierarchy of objects in your application 

e Literal values that can be fetched by the application 


The UIL compiler has built-in tables containing information about widgets 
and gadgets. For every object in the XUI Toolkit, the UIL compiler knows 
which objects are valid children of the object, the object’s arguments, and 
the valid callback reasons for the object. 


Advantages to Using UIL 


Creating a user interface for a VMS DECwindows application using UIL 
offers the following advantages: 


Easier Coding 


You can specify an interface more quickly using UIL because you do not 
have to know the specific creation routines or the format of their argument 
lists. You need to include only those object arguments you want to change. 
In general, you can specify these arguments in any order. 
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Because UIL is a specification language that describes the characteristics 
of an interface, there is no need for control flow. Therefore, you can 
define objects in your UIL specification in roughly the same order that the 
objects are arranged in the widget hierarchy of your application interface. 
This makes it easier for a programmer reading the UIL specification to 
interpret the design of the interface. 


At run time, when the interface objects are created, DRM performs some 
Toolkit routine calls for you as a convenience, thus simplifying your 
programming tasks. 


Earlier Error Detection 


The UIL compiler does type checking for you that is not available with the 
XUI or X Toolkits, so that the interface you specify has fewer errors. 


The UIL compiler issues diagnostics if you specify any of the following: 
e The wrong type of value for an argument 

e An argument to an object that is not supported by that object 

e A reason for an object that the object does not support 

¢ Achild of an object that the object does not support 


Separation of Form and Function 


When you use UIL, you define your application interface in a separate UIL 
module rather than by directly calling XUI Toolkit creation routines in 
your application program. This lets you separate the form your interface 
takes from the functions provided by the application. By separating form 
and function, it becomes feasible to have multiple interfaces that share 

a common set of functions. This is beneficial, for example, when you are 
building an application that will be used by people who speak different 
languages. 


In general, you can freely change the appearance of the interface (for 
example, by repositioning widgets or changing their borders or colors) 
without recompiling the application program. . 


Faster Prototype Development 


UIL helps you develop prototypes of user interfaces for an application. You 
can create a variety of interfaces in a fairly short time. You can get an 
idea of the look of each interface before any of the functional routines are 
written. 


The ability to specify the user interface separately lets designers work 
with end users at the same time programmers are coding the functions of 
the application. Because both groups can work more or less independently, 
the complete application can be delivered in less time than if the interface 
design were part of the application code. 
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Features of UIL 
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1.2 Advantages to Using UIL 


interface Customization 


You can customize an interface by putting in place a hierarchy of UID files 
(calied a UID hierarchy). At run time, DRM searches this file hierarchy 
in the sequence you specify to build the appropriate argument lists for the 
low-level widget creation routines. 


One use of this feature would be to provide an interface in several 
languages. The text on title bars, menus, and so on, can be displayed in 
the language of the end user without altering anything in the application. 
In this case, the files in the UID hierarchy represent alternative interfaces. 


Another use of the UID hierarchy feature would be to isolate individual, 
department, and division customizations to an interface. In this case, 
you can think of the files in the UID hierarchy as superimposed, with the 
definitions in the first file listed in the array supplied to the DRM routine 
OPEN HIERARCHY taking precedence. 





UIL offers many features to increase productivity and the flexibility of 
your programs. 


Named Values 


Instead of directly specifying the values for widget and gadget attributes, 
you can use named values, which are similar to variables in a 
programming language. You give a literal value (such as an integer or 
string) a name and then use the name in place of the value specification. 
Using named values makes your UIL specification easier to understand 
and isolates changes. 


In addition, you can use DRM routines to fetch named values from the 
UID file for use at run time. 


Compile-Time Expressions 


You can use expressions to specify values in UIL. A valid UIL expression 
can contain integers, strings, floating-point numbers, Booleans, named 
values, and operators. Using expressions can make values more 
descriptive (for example, "dialog_box_width/2") and can help you avoid 
recomputing values (for example, if you needed to change the size or 
position of the dialog box). 


Identifiers 


Identifiers provide a mechanism for referencing values in UIL which are 
provided by the application at run time. In the application program, you 
can use a DRM routine to associate a value with the identifier name. 
Unlike a named value, an identifier does not have an associated data type. 
You can use an identifier as an attribute value or callback procedure tag, 
regardless of the data type specified in the object or procedure declaration. 
Identifiers are useful for specifying position based upon the type of 
terminal on which the interface will be displayed or for passing a data 
structure (as opposed to a constant) to a callback procedure. 
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Lists 


UIL allows you to create named lists of attributes, sibling widgets, and 
callback procedures that you can later refer to by name. This feature 
allows you to easily reuse common definitions by simply referencing these 
definitions by name. 


Support for Compound Strings 


Most XUI Toolkit widgets require strings used in the user interface (labels, 
menu items, and so on) to be compound strings. UIL fully supports use of 
compound strings, including left-to-right and right-to-left writing direction 
and choice of fonts. 


Include Files for Useful Constants 


The XUI Toolkit provides include files (one for each of the VMS and MIT C 
bindings) that contain useful constants for coding a user interface in UIL. 
For example, several widgets have an orientation attribute. You can use 
the constants DwtOrientationHorizontal or DwtOrientationVertical 
(in the MIT C binding) to specify the orientation attributes. 


1.4 Where to Find More Information 
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This manual contains reference information on the User Interface 
Language and the UIL compiler. For information on specifying an 
interface using UIL and creating the interface at run time using DRM, 
see the VMS DECwindows Guide to Application Programming. 


For reference information on DRM routines, see the VMS DECwindows 
Toolkit Routines Reference Manual. 


2 UIL Language Syntax 


This chapter describes the syntax rules for the following low-level language 
elements: 


¢ Character set 


e Names 
e Keywords 
e §6Literals 


e Value-generating functions 
e ANY data type 


The chapter also describes include files for UIL constants, character sets 
for compound strings, and compile-time value expressions. 


UIL is a free-form language. This means that high-level constructs such 
as object and value declarations do not need to begin in any particular 
column and can span any number of lines. Low-level constructs such 
as keywords and punctuation characters can also begin in any column; 
however, except for string literals and comments, they cannot span lines. 


The UIL compiler accepts input lines up to 132 characters in length. 


2.1 Character Set and Punctuation Characters 


Note: 


Elements of UIL are constructed using the characters in Table 2-1. 


Table 2-1 UIL Character Set 


Alphabetic characters ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklmnopaqrstuvwxyz 

Numeric characters 0123456789 

UIL punctuation and 1 ()*,4+ —/:=!B\Q 

formatting characters space, tab, form feed 


Other characters &[] |] <>%"#?@~‘4 
DEC Multinational Character in the range 160 to 255 decimal 





Alphabetic, numeric, and punctuation and formatting characters are used 
to build the elements of UIL. Other characters are valid only in comments 
and string literals. 


Control characters (except for the form-feed character) are not 
permitted in a UIL module; the form-feed character is permitted 
in column 1 only. Escape sequences (described in Section 2.4) must 
be used to construct a string literal containing a control character. 
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2.1.1 Punctuation Characters 


Use the character sequences shown in Table 2—2 to punctuate a UIL 
module. 


Table 2-2 UiL Punctuation Characters 


( Left parenthesis ) Right parenthesis 
{ Left brace } Right brace 

\ Backslash ! Exclamation mark 
I* Slash asterisk i Asterisk slash 

; Semicolon : Colon 
Apostrophe ; Comma 

= Equal sign 





Punctuation in a UIL module resembles that used in C programs. For 
example, statements end in a semicolon (;), braces ( {} )-are used to delimit 
definitions, and comments can be delimited by the /* and */ character 
sequences. 


2.1.2 Spaces, Tabs, Form-Feed Characters, and Comments 
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Spaces, tabs, and comments are special elements in the language. They 
are a means of delimiting other elements, such as two names. One or 
more of these elements may appear before or after any other element in 
the language. However, spaces, tabs, and comments that appear in string 
literals are treated as character sequences rather than as delimiters. 


Comments can take one of two forms, as follows: 


¢ The comment is introduced with the sequence /* followed by the text 
of the comment and terminated with the sequence */. This form of 
comment may span multiple source lines. 


¢ The comment is introduced with the character ! followed by the text of 
the comment and terminated by the end of the source line. 


Neither form of comment can be nested. 


The form-feed character is a control character and therefore cannot appear 
directly in a UIL specification file. You must use the escape sequence \12\ 
instead (see Table 2-6). There is one exception to this rule; you can place 
a form feed character in column 1 of a source line due to the common 
practice of VMS editors separating parts of a program with a form feed. 
The form feed causes a page break in the module listing. 
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Each entity in UIL (such as a value, procedure, or object) can be identified 
by a name. This name is also used to reference the entity elsewhere in the 
VIL module. 


Names can consist of any of the characters A through Z, a through z, 0 
through 9, dollar sign ($), and underscore (_). Names cannot begin with 
a digit (0 through 9). The maximum length of a name is 31 characters. 


UIL gives you a choice of either case-sensitive or case-insensitive names 
through a clause in the module header (described in Section 3.1.2). For 
example, if names are case sensitive, then the names “sample” and 
“Sample” are distinct from each other. If names are case insensitive, 
these names would be treated as the same name and could be used 
interchangeably. 


In case-insensitive mode, the compiler outputs all names in the User 
Interface Definition (UID) file in uppercase form. 


In case-sensitive mode, two names are the same only if the names contain 
exactly the same characters. In this mode, names appear in the UID file 
exactly as they appear in the source. 


By default, names are case insensitive. 


UIL has a single name space; therefore, you must define any referenced 
name exactly once in a UIL module. If you inadvertently define the same 
name more than once or omit a definition, the UIL compiler issues an 
error at compilation time. 





Keywords are a set of names that have special meaning in UIL. They 
are of two types: reserved and nonreserved. You cannot use a reserved 
keyword to name an entity in UIL. Nonreserved keywords can be used as 
names. 


If you specify case-insensitive mode, you can type UIL keywords in either 
uppercase, lowercase, or mixed case. 


If you specify case-sensitive mode, you must type UIL keywords in 
lowercase. 


Keywords cannot be abbreviated by truncating characters from the end. 


Table 2-3 lists reserved keywords in alphabetical order. 


Table 2-3 Reserved UIL Keywords 
Keyword Description 


ARGUMENTS __ Identifies an arguments list. 
CALLBACKS Identifies a callbacks list. 


(continued on next page) 
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Table 2-3 (Cont.) Reserved UIL Keywords 





Keyword 


CONTROLS 
END 
EXPORTED 


FALSE 
GADGET 


IDENTIFIER 
INCLUDE 
LIST 
MODULE 
OBJECT 
OFF 

ON 
PRIVATE 


PROCEDURE 
PROCEDURES 


TRUE 
VALUE 
WIDGET 


Description 


Identifies a controls list. 
Signifies the end of the module. 


Specifies that this object or value can be referenced by other UIL 
modules. 


Represents the Boolean value 0; synonym for OFF. 


For objects having a widget and a gadget variant, specifies this 
object as the gadget variant. 


Indicates an identifier declaration. 

Used with the nonreserved keyword FILE to specify an include file. 
Identifies a list declaration. 

Signifies the start of a UIL module. 

Identifies an object declaration. 

Represents the Boolean value 0; synonym for FALSE. 

Represents the Boolean value 1; synonym for TRUE. 


Specifies that this object or value cannot be referenced by other UIL 
modules. 


Identifies a procedure declaration. 

Identifies a procedures list. 

Represents the Boolean value 1; synonym for ON. 
Identifies a value (literal) declaration. 


For objects having a widget and a gadget variant, specifies this 
object as the widget variant. 


Keywords listed in Table 2—4 are nonreserved keywords that you can use 
as names without generating an error. Note, however, that if you use any 
of these keywords as a name, you cannot use the UIL-supplied meaning of 
that keyword. For example, if you use the name of an argument (such 

as x) as the name of a value, you cannot specify the x argument in any 
object definitions. 


Table 2-4 Nonreserved UIL Keywords 


Keyword 


Description 





Built-in argument names' 
(for example: x, height) 


Built-in reason names' 


Identifies an object argument (widget-specific 
attribute). 


Identifies a callback reason. 


(for example: activate, help) 


'Appendix B lists built-in argument names, reason names, and object types. 


(continued on next page) 


UIL Language Syntax 
2.3 Keywords 


Table 2—4 (Cont.) Nonreserved UIL Keywords 


Keyword 


Character set names? 


(for example: ISO_LATIN1) 


Object types' 


(for example: push_button, 


dialog_box) 
ANY 
ARGUMENT 


ASCIZ_STRING_TABLE 


ASCIZ_TABLE 
BACKGROUND 


BOOLEAN 
CASE_INSENSITIVE 


CASE_SENSITIVE 


CLASS_REC_NAME 


COLOR 
COLOR_TABLE 
COMPOUND_STRING 


COMPOUND_STRING_. 


TABLE 
FILE 


FLOAT 


FONT 
FONT_TABLE 
FOREGROUND 


ICON 


IMPORTED 


Description 


Identifies a character set and its writing direction. 


Identifies a DECwindows interface object. 


Suppresses data type checking. 

Identifies the built-in ARGUMENT function. 
Specifies a value as the UIL data type asciz_table. 
Specifies a value as the UIL data type asciz_table. 


In a color table, specifies monochrome mapping to 
the background color. 


Specifies a literal as UIL data type boolean. 


Used with the nonreserved keyword NAMES to 
specify that names and keywords in the module are 
case insensitive. 


Used with the nonreserved keyword NAMES to 
specify that names and keywords in the module are 
case sensitive. 


Specifies a value as the UIL data type class_rec_ 
name. 


Specifies a value as the UIL data type color. 
Specifies a value as the UIL data type color_table. 


Specifies a value as the UIL data type compound_ 
String; identifies the built-in COMPOUND_STRING 
data conversion function. 


Specifies a value as the UIL data type string_table. 


Used with the reserved keyword INCLUDE to specify 
an include file. 


Specifies a literal as UIL data type float; identifies the 
FLOAT data conversion function. 


Specifies a value as the UIL data type font. 
Specifies a value as the UIL data type font_table. 


In a color table, specifies monochrome mapping to 
the foreground color. 


Specifies a value as the UIL data type pixmap; 
identifies the built-in ICON function. 


Specifies that this literal takes its value from a 
corresponding literal in another UIL module. 


' Appendix B lists built-in argument names, reason names, and object types. 


2Table 2~7 lists UIL character set names. 


(continued on next page) 
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Note: 


Table 2-4 (Cont.) Nonreserved UIL Keywords 


Keyword Description 

INTEGER Specifies a literal as UIL data type integer; identifies 
the INTEGER data conversion function. 

INTEGER_TABLE Specifies a value as the UIL data type integer_table. 

MANAGED Specifies that a child is managed by its parent. 

NAMES Identifies the case-sensitivity clause. 

OBJECTS Identifies the default object variant clause. 

PIXMAP Specifies a value as the UIL data type pixmap. 

REASON Specifies a value as the UIL data type reason. 

RIGHT_TO_LEFT Specifies writing direction in the COMPOUND_ 
STRING function. 

STRING Specifies a literal as the UIL data type string. 

STRING_TABLE Specifies a value as the UIL data type string_table. 

TRANSLATION_TABLE Specifies a value as the UIL data type translation_ 
table. 

UNMANAGED Specifies that a child is unmanaged by its parent. 

VERSION Identifies the version clause. 

XBITMAPFILE Specifies a value as the UIL data type pixmap; 


identifies the XBITMAPFILE function. 


In this chapter, all examples assume case-insensitive mode. 
Keywords are shown in uppercase letters to distinguish them 
from user-specified names, which are shown in lowercase letters. 
This use of uppercase letters is not required in case-insensitive 
mode. In case-sensitive mode, keywords must be in lowercase 
letters. 


In the following example, ARGUMENTS is a keyword and circle_radius is 
a user-defined name having the integer value 1000. In your UIL module, 
you could type the keyword ARGUMENTS in lowercase, uppercase, or 
mixed-case letters as long as you specified that names are case insensitive. 


{ ARGUMENTS 
{ circle radius = 1000; }; 





Literals 
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Literals are one means of specifying a value. UIL provides literals for 
several of the value types it supports. Some of the value types are not 
supported as literals (for example, pixmaps and string tables). You 

can specify values for these types by using functions provided by UIL 
(described in Section 2.5). Literal types supported by UIL are as follows: 


2.4.1 


String Literals 
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¢ String 
¢ Integer 
¢ Boolean 


¢ Floating-point 


You can designate UIL objects and values as exported, imported, or 
private. An exported object or value can be referenced in another UIL 
module by using the same name for the object or value and indicating that 
the object or value is to be imported. By default, UIL objects and values 
are private, and are not accessible by other UIL modules. Section 3.2 
explains the scope of UIL objects and values in more detail. 


A string literal is a sequence of zero or more 8-bit or 16-bit characters or a 
combination of both delimited by apostrophes (’ ) or quotation marks ("). 
String literals can be no more than approximately 2000 characters long. 


A single-quoted string literal can span multiple source lines. To continue a 
single-quoted string literal, terminate the continued line with a backslash 
(\). The literal continues with the first character on the next line. 


Double-quoted string literals cannot span multiple source lines. (Because 
double-quoted strings can contain escape sequences and other special 
characters, you cannot use the backslash character to designate 
continuation of the string.) To build a string value that must span 
multiple source lines, use the concatenation operator. See Section 2.4.1.3 
for a description of how to concatenate strings. 


The syntax of a string literal is one of the following: 
‘[— char... J’ 
{ #char-set J[ char... j"™" 


Both string forms associate a character set with a string value. The 
UIL compiler uses the following rules to determine the character set and 
storage format for string literals: 


¢ Astring declared as ‘string’ is equivalent to #ISO_LATINI1 "string". 


e Astring declared as "string" is equivalent to #char-set"string" if 
you specified char-set as the default character set for the module. 
Otherwise, "string" is equivalent to #ISO_LATIN1 "string". 


¢ Astring of the form "string" or #char-set"string" is stored as a null- 
terminated string unless the string consists of mixed 8-bit and 16-bit 
DEC_HANZI or DEC_KANJI characters (in which case the string is 
stored as a compound string). 


e Ifa string of the form #DEC_HANZI'"string" or #DEC_KANJI"string" 
consists of all 8-bit characters, the string is stored as if it were an 
ISO_LATIN1 string. 
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e Ifa string of the form #DEC_HANZI"string" or #DEC_KANJI"string" 
consists of all 16-bit characters, the string is stored as a null- 
terminated string, but retains its character set information in the 


UID file. 


Table 2—5 gives examples of valid and invalid string literal syntax. Note 
that the COMPOUND_STRING function (described in Section 2.5.6) forces 
the UIL compiler to generate a compound string. 


Table 2-5 Examples of String Literal Syntax 


Form 


‘string’ 
#char-set’ string’ 


COMPOUND_STRING(’ string’ ) 
"string" 


#ISO_GREEK "string" 
COMPOUND_STRING("string") 


COMPOUND_STRING(#ISO_ARABIC string") 
‘string’ &" string" 


"string" &#ISO_HEBREW"string" 


‘string’ &#DEC_KANuJI"8-bit string" 
‘string’ &#DEC_KANJI" 16-bit string" 


Storage Format 


Null-terminated string 


Invalid syntax; will not 
compile 


Compound string 
Null-terminated string’ 


Null-terminated string’ 
Compound string 


Compound string 


If the character sets and 
writing directions of the 
operands match, the resulting 
string is null-terminated; 
otherwise, the result is a 
multiple-segment compound 
string’ 

If the implicit character set 
and writing direction for 

the left operand matches 
the explicit character set 
(ISO_HEBREW) and writing 
direction (right to left) for the 
right operand, the resulting 
string is a null-terminated 
string; otherwise, the 

result is a multiple-segment 
compound string’ 


Nuil-terminated string’ 
Compound string 


Character Set 


ISO_LATIN1 
Not applicable 


ISO_LATIN1 


Default character set specified 
for the module; otherwise, 
ISO_LATIN1 


ISO_GREEK 


Default character set specified 
for the module; otherwise, 
ISO_LATIN1 

ISO_ARABIC 


Character set or sets specified 
for the individual segments 


Character set or sets specified 
for the individual segments 


ISO_LATINA 


ISO_LATIN1 for the first 
segment and DEC_KANuI for 
the second segment 





'For the DEC_HANZI or DEC_KANJI character sets, a string consisting of mixed 8-bit and 16-bit characters results in a 


compound string. 





UIL Language Syntax 
2.4 Literals 


Note that string literals can contain characters with the 8-bit (high-order) 
set. You cannot type control characters (00 ...1F, 7F, and 80... 9F) 
directly in a single-quoted string literal. However, you can represent these 
characters with escape sequences. The characters listed in Table 2-6 
cannot be directly entered in a UIL module. You must use the indicated 
escape sequence to enter these characters in a string literal. 


Table 2-6 UIL Escape Sequences for String Values 


Escape 

Sequence Meaning 

\b Backspace 

\f Form feed 

\n New line’ 

\r Carriage return 
\t Horizontal tab 
\v Vertical tab 

\? Apostrophe 

AN Quotation mark 
\\ Backslash 
\integen Character whose internal representation is given by integer, in the 


range 0 to 255 decimal 


‘For VMS Version 5.3 and 5.4, the UIL compiler does not process newline characters that 
are embedded in compound strings. The effect of a newline character that is embedded in 
compound strings is now solely dependent on the character set specified, and the result may 
not always be the creation of multiline compound strings. 


Most XUI Toolkit routines use the null character to determine the end of 
a string. Therefore, you cannot pass strings with embedded nulls to the 
Toolkit. 


2.4.1.1 Compound String Literals 
In addition to its character value, a compound string consist of two 
properties: an 8-bit or a 16-bit character set and a writing direction. 
The UIL data type for a compound string is compound_string. 


These properties are needed to fully understand the value of the string. 
For example, if the character set of a string is DEC_KANJI (Japanese), 
the value of the string may contain a mixture of 8-bit and 16-bit codes. 
Character sets are also important for choosing the font in which to display 
a character string. If a character string has the ISO_.HEBREW character 
set, a font that contains Hebrew characters should be used to display the 
string’s value. 


To create multiline compound strings, you must now create multisegment 
compound strings with separators. This can be accomplished in UIL 
with the SEPARATE = (boolean_expression) clause of the COMPOUND_ 
STRING function (see Section 2.5.6) and the string concatenation 
character (&). For example, in VMS Version 5.1, the UIL compiler 
recognized the following. 
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value 
sample string : compound_string ("Hello\nWorld!"); 


However, for VMS Version 5.3 and Version 5.4, you must now enter the 
following: 


value 
sample _linel : compound_string ("Hello", separate = true); 
sample _line2 : compound_string ("World!"); 
sample string : sample linel & sample_line2; 


You can still attain VMS Version 5.1 behavior of compound strings by 
using the /VERSION qualifier when you compile your UIL specification 
file. The default for the /VERSION qualifier is /VERSION=V2. See 
Section 4.1.4 for more information on the /VERSION qualifier. 


The writing direction of a compound string is implied by the character set 
specified for the string. You can explicitly set the writing direction for a 
compound string by using the COMPOUND_STRING function (described 
in Section 2.5.6). Section 2.4.1.2 describes the character sets supported in 
UIL for compound strings. 


A compound string can consist of a sequence of concatenated strings, each 
of which can have a different character set property and writing direction. 
(You can concatenate null-terminated strings with compound strings; the 
result is a compound string.) Use the concatenation operator (described in 
Section 2.4.1.3) to create a sequence of compound strings. The following is 
an example of concatenated compound strings: 


#ISO_HEBREW"txet werbeh"&#ISO_LATIN8"latin text" 


Each string in the sequence is stored along with information about the 
character set and writing direction. You can manipulate a compound 
string with the XUI Toolkit routines for compound strings. 


Generally, a string literal is stored in the UID file as a compound string 
when the literal consists of concatenated strings having different character 
sets or writing directions, or when you use the string to specify a value for 
an argument that requires a compound string value (see Section 2.4.1.4). 
If you want to guarantee that a string literal is stored as a compound 
string, you must use the COMPOUND_STRING function described in 
Section 2.5.6. 


2.4.1.2 Character Sets for String Literals 
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The character sets supported by the UIL compiler are listed in Table 2-7. 


The first column shows the UIL name for the character set. The second 
column indicates whether characters in this set are represented in 8 or 16 
bits. The third column gives a brief description of the character set. Note 
that several UIL names map to the same character set. In some cases, the 
UIL name influences how string literals are read. For example, strings 
identified by a UIL character set ending in _LR are read left to right. 
Names that end in a different number reflect different fonts (for example, 
ISO_LATIN1 or ISO_LATIN6). 
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Table 2-7 UlIL-Supported Character Sets 


UIL Name Size Description 
ISO_LATIN1 8-bit GL: ASCII, GR: Latin-1 Supplement 
ISO_LATIN2 8-bit GL: ASCII, GR: Latin-2 Supplement 
ISO_ARABIC 8-bit GL: ASCII, GR: Latin-Arabic Supplement 
ISO_LATING6 8-bit | GL: ASCII, GR: Latin-Arabic Supplement 
ISO_GREEK 8-bit GL: ASCII, GR: Latin-Greek Supplement 
ISO_LATIN7 8-bit GL: ASCII, GR: Latin-Greek Supplement 
ISO_HEBREW 8-bit GL: ASCII, GR: Latin-Hebrew Supplement 
ISO_LATIN8 8-bit GL: ASCII, GR: Latin-Hebrew Supplement 
ISO_HEBREW_LR 8-bit GL: ASCII, GR: Latin-Hebrew Supplement 
ISO_LATIN8_LR 8-bit GL: ASCII, GR: Latin-Hebrew Supplement 
JIS_KATAKANA 8-bit GL: JIS Roman, GR: JIS Katakana 
DEC_TECH 8-bit | GL: DEC Spec Graphics, GR: DEC Technical 
DEC_KANJI 16-bit DEC Kanji Character Set (Japanese) 
DEC_HANZI 16-bit oe Hanzi Character Set (People’s Republic of 
hina) 


In the following example, the characters in the string value are presented 
right to left: 


#ISO_HEBREW"tfel ot thgir morf og sretcarahc" 


Because the character set for the literal is ISO_.HEBREW, the characters 
in quotation marks can be any legal character as defined by the ISO_ 
HEBREW character set. Table 2-8 lists the parsing rules for each of the 
character sets. 


Table 2-8 Parsing Rules for Character Sets 


Character Set Parsing Rules 
All character sets Character codes in the range 00..1f, 7f, and 80..9f are control 


characters, including both bytes of 16-bit characters. The 
compiler flags these as illegal characters. 


ISO_LATIN1 These sets are parsed from left to right. The escape 
ISO_LATIN2 sequences given for null-terminated strings’ are also 
ISO_ARABIC supported by these character sets. 

ISO_LATIN3 

ISO_GREEK 

ISO_LATIN4 


'See Table 2-6 for a description of escape sequences for null-terminated strings. 


(continued on next page) 
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Table 2-8 (Cont.) Parsing Rules for Character Sets 


Character Set Parsing Rules 
ISO_HEBREW These sets are parsed from right to left; for example, the 
ISO_LATINS8 string #ISO_HEBREW"012345" generates the string 


"543210" with character set ISO_HEBREW. The writing 
direction for this segment is marked as being right_to_left. 


The escape sequences given for null-terminated strings' 
are also supported by these character sets. The characters 
that comprise the escape sequence are in left-to-right order. 
Therefore, you type \n, not n\. 

ISO_LATIN8_LR These sets are parsed from left to right, so the string #ISO_ 
LATIN8_LR"012345" generates the string "012345" with 
character set ISO_LATIN8. The writing direction for this 
segment is marked as being right_to_left. The escape 
sequences given for null-terminated strings' are also 
supported by these character sets. 

JIS_KATAKANA This set is parsed from left to right. The escape sequences 
given for null-terminated strings' are also supported by this 
character set. Note that the backslash (\) can be displayed 
as a yen symbol. 

DEC_KANJI These sets are parsed from left to right. The string can 

DEC_HANZi contain a mixture of 8-bit and 16-bit codes; 8-bit codes are in 
the range 00-7F. A character in the range AO-FF is assumed 
to be the first byte of a 2-byte character. Among the 8-bit 
characters, the escape sequences given for null-terminated 
strings’ are also supported by these character sets. 

If a DEC_KANJI or DEC_HANZ!I literal contains both 8-bit and 
16-bit characters, it is a compound string with each sequence 
of 8-bit characters marked as ISO_LATIN1, and each 16-bit 
character sequence marked as DEC_KANJI or DEC_HANZI. 
If a DEC_HANZI or DEC_KANJI literal contains only 8-bit 
characters, the string is stored as a null-terminated string. 


1See Table 2-6 for a description of escape sequences for null-terminated strings. 


In addition to designating parsing rules for strings, character set 
information remains an attribute of a compound string. If the character 
set is included in a compound string consisting of several concatenated 
segments, the character set information for that string segment is 
retained. This gives the XUI Toolkit the information it needs to decipher 
the compound string and to choose a font to display the string. 


For an application interface displayed only in English, UIL lets you ignore 
the distinctions between the two uses of strings. The compiler recognizes 
by context when a string must be passed as a null-terminated string or as 
a compound string. 


For an application interface displayed in a variety of languages, UIL 
provides a mechanism for distinguishing the two uses of text and tries to 
make the UIL specification moderately easy to create with a multilingual 
editor. 
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The UIL compiler recognizes enough about the various character sets to 
correctly parse string literals. The compiler also issues errors if you use a 
compound string in a context that supports only null-terminated strings. 


This means that a mixture of 8-bit and 16-bit characters for DEC_KANJI 
and DEC_HANZI literals and the right-to-left insertion for ISO_HEBREW 
literals is permitted. Furthermore, the UIL compiler recognizes the 
requirements of object arguments, and issues errors if you use a compound 
string in a context that supports only null-terminated strings. 


The character set specification is optional in a string value. If omitted 
from a compound string, the character set is assumed to be the default for 
the module as specified in the module declaration (see Section 3.1.3). The 
default character set for null-terminated strings is ISO_LATINI1 (which is 
vendor-independent and matches the default font for VMS DECwindows). 


Since the character set names are keywords, you must put them in 
lowercase if case-sensitive names are in force. If names are case 
insensitive, character set names can be either uppercase, lowercase, or 
mixed case. (See Section 3.1.2 for more information on case sensitivity for 
UIL names.) 


2.4.1.3 Concatenated String Literals 
The concatenation operator (& ) takes two strings as operands and creates 
a new string made up of the left operand followed immediately by the right 
operand. 


For example, ‘abcd’ & 'xyz’ becomes ’ abcdxyz’. 


The right and left operands of the concatenation operator can be null- 
terminated strings, compound strings, or a combination. The operands can 
hold string values of the same or different character sets. 


The string resulting from the concatenation is a null-terminated string 
unless one or more of the following conditions exists: 


¢ One of the operands is a compound string. 
e The operands have different character set properties. 


e The operands have different writing directions. 


If one or more of these conditions exists, the resulting string is a compound 
string. You cannot use imported or exported values as operands of the 
concatenation operator. (See Section 3.2 for information on declaring 
values as private, exported, or imported.) 


2.4.1.4 Data Storage Consumption for String Literals 
The way a string literal is stored in the UID file depends on how you 
declare and use the string. The UIL compiler automatically converts a 
null-terminated string to a compound string if you use the string to specify 
the value of an argument that requires a compound string. However, this 
conversion is costly in terms of storage consumption. 


Private, exported, and imported string literals require storage for a single 
allocation when the literal is declared; thereafter, storage is required for 
each reference to the literal. Literals declared in line require storage for 
both an allocation and a reference. 
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Table 2-9 summarizes data storage consumption for string literals. The 
storage requirement for an allocation consists of a fixed portion and a 
variable portion. The fixed portion of an allocation is roughly the same 

as the storage requirement for a reference (a few bytes). The storage 
consumed by the variable portion depends on the size of the literal value 
(that is, the length of the string). To conserve storage space, avoid making 
string literal declarations that result in an allocation per use. 


Table 2-9 Data Storage Consumption for String Literals 
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Declaration Data Type 

In line Null-terminated 
Private Null-terminated 
Exported Null-terminated 
Imported Null-terminated 
In line Null-terminated 
Private Null-terminated 
Exported Null-terminated 
Imported Null-terminated 
In line Compound 
Private Compound 
Exported Compound 
Imported Compound 
Integer Literals 


Used As 


Null-terminated 
Null-terminated 
Null-terminated 
Null-terminated 


Compound 
Compound 
Compound 
Compound 


Compound 
Compound 
Compound 
Compound 


Storage Requirements per Use 


An allocation and a reference (within the module) 
A reference (within the module) 

A reference (within the UID hierarchy) 

A reference (within the UID hierarchy) 


An allocation and a reference (within the module) 
An allocation and a reference (within the module) 
A reference (within the UID hierarchy) 
A reference (within the UID hierarchy) 


An allocation and a reference (within the module) 


- Areference (within the module) 


A reference (within the UID hierarchy) 
A reference (within the UID hierarchy) 


An integer literal represents the value of a whole number. Integer literals 
have the form of an optional sign followed by one or more decimal digits. 
An integer literal must be in the range —2,147,483,647 to 2,147,483,647. 
An integer literal must not contain embedded spaces or commas. 


Integer literals are stored in the UID file as longwords. Exported and 
imported integer literals require a single allocation when the literal is 
declared; thereafter, a few bytes of storage are required for each reference 
to the literal. Private integer literals and those declared in line require 
allocation and reference storage per use. To conserve storage space, avoid 
making integer literal declarations that result in an allocation per use. 


Table 2-10 shows data storage consumption for integer literals. 
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Table 2-10 Data Storage Consumption for Integer Literals 


Declaration Storage Requirements per Use 

In line An allocation and a reference (within the module) 
Private An allocation and a reference (within the module) 
Exported A reference (within the UID hierarchy) 

Imported A reference (within the UID hierarchy) 





2.4.3 Boolean Literals 


A Boolean literal represents the value true (reserved keyword TRUE or 
ON) or false (reserved keyword FALSE or OFF). The reserved keywords 
TRUE and FALSE are subject to case-sensitivity rules. 


In a UID file, TRUE is represented by the integer value 1, and FALSE is 
represented by the integer value 0. 


Data storage consumption for Boolean literals is the same as that for 
integer literals. 


2.4.4 Floating-Point Literals 


A floating-point literal represents the value of a real (or floating-point) 
number. Floating-point literals have the form: 


[+ | -] digit... [ digit. ][{E}] e}[+ | -] digit.. ] 
or 
[+ ]-]. digit. [{ E | e} [+ | -] digit. ] 


A floating-point literal can represent values in the range .29E-38 to 
1.7E+38 with up to 16 significant digits. A floating-point literal must not 
contain embedded spaces or commas. 


Floating-point literals are stored in the UID file in D-floating-point format. 
Table 2-11 gives examples of valid and invalid floating-point notation for 
the UIL compiler. 


Table 2-11 Valid and Invalid Floating-Point Notation 


Valid Floating-Point Literals invalid Floating-Point Literals 
1.0 1e1 (no decimal point) 
1 E~1 (no decimal point or digits) 


3.1415E-2 (which equals .031415) 2.87 e6 (embedded bianks) 
-6.29e7 (which equals -62900000) 2.0e100 (out of range) 


Data storage consumption for floating-point literals is the same as that for 
integer literals. 
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2.5 Value-Generating Functions 
UIL provides functions to generate the following types of values: 
¢ Colors 
¢ Pixmaps 
¢ Fonts 
¢ Font tables 
e Class record names 
¢ Compound strings 
¢ Compound string tables 
¢ ASCIZ string tables 
e Integer tables 
e Arguments 
e Reasons 


e Translation tables 


Note: In this chapter, all examples assume case-insensitive mode. 
Keywords are shown in uppercase letters to distinguish them 
from user-specified names, which are shown in lowercase letters. 
This use of uppercase letters is not required in case-insensitive 
mode. In case-sensitive mode, keywords must be in lowercase 
letters. 


2.5.1 COLOR Function 


The COLOR function supports the definition of colors. Using the COLOR 
function, you can designate a value to specify a color and then use that 
value for arguments requiring a color value. This function returns a value 
of type color. 


The COLOR function has the following syntax: 
COLOR (string_expression [, FOREGROUND | ,BACKGROUND)) 


The string expression names the color you want to define; the optional 
keywords FOREGROUND and BACKGROUND identify how the color is 
to be displayed on a monochrome device when the color is used in the 
definition of a color table (see Section 2.5.2). 


Example 2-1 shows how to use the COLOR function. 


In this example, the COLOR function is used with the VALUE declaration 
(described in Chapter 3) to define three colors and give them each a name. 
One of these colors, green, is then used to specify the foreground color of 
the main window. 
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Example 2-1 Using the COLOR Funciion 


VALUE red: COLOR( ‘Red’ ); 
VALUE green: COLOR( ’Green’ ); 
VALUE blue: COLOR( ‘Blue’ ); 


OBJECT primary window: MAIN WINDOW 
{ ARGUMENTS 
{ FOREGROUND_COLOR 
BACKGROUND_COLOR 
hi 


green; 
COLOR( ‘Black’ ); 


}3 


A second use of the COLOR function defines the background color for the 
main window as the color associated with the string ’ Black’. 


The UIL compiler does not have built-in color names. Colors are a server- 
dependent attribute of an object. Colors are defined on each server and 
may have different RGB values on each server. The string you specify 
must be recognized by the server on which your application runs. 


In a UID file, UIL represents a color as a character string. The XUI 
Resource Manager (DRM) calls X translation routines that convert a 
color string to the device-specific pixel value. If you are running on a 
monochrome server, all colors automatically translate to black or white. If 
you are on a color server, the color names translate to their proper colors 
if the following conditions are met: 


¢ The color is defined. 


¢ The color map is not yet full. 


If the color map is full, even valid colors translate to black or white 
(foreground or background). 


If you have the VMS DECwindows software installed on your system, 
you can see a list of the color name strings understood by the VMS 
DECwindows servers by entering the following command: 


$ TYPE SYSSMANAGER: DECWSRGB.COM 


The command procedure DECW$RGB.COM is executed during VMS 
DECwindows startup to set up the mapping of color names to RGB 

color indexes. These names are defined so that you can use reasonable 
names, rather than specifying numeric color levels, to pick colors. (The 
server stores the equivalent numeric color levels of color names in the file 
XDEFAULTS.DAT file.) 


To write an application that runs on both monochrome and color devices, 
you need to specify which colors in a color table (defined with the COLOR_ 
TABLE function; see Section 2.5.2) map to the background and which 
colors map to the foreground. UIL lets you use the COLOR function to 
designate this mapping in the definition of the color. Example 2-2 shows 
how to use the COLOR function to map the color red to the background 
color on a monochrome device. 
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Example 2-2 Using the COLOR Function to Define Monochrome 
Mapping for a Color 


VALUE c: COLOR ( ’red’,BACKGROUND ); 


Mapping comes into play only when DRM is given a color and the 
application is to be displayed on a monochrome device. In this case, 
each color is considered to be in one of the following three categories: 


¢ The color is mapped to the background color on the monochrome 
device. 


¢ The color is mapped to the foreground color on the monochrome device. 


¢ Monochrome mapping is undefined for this color. 


If the color is mapped to the monochrome foreground or background color, 
DRM substitutes the foreground or background color, respectively. If you 
do not specify the monochrome mapping for a color, DRM passes the color 
string to the XUI Toolkit for mapping to the foreground or background 
color. 


2.5.2 Functions for Specifying Pixmaps 
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Pixmap values are designed to let you specify labels that are graphic 
images rather than text. Pixmap values are not directly supported by UIL. 
Instead, UIL supports icons, which are a simplified form of pixmap. You 
use a character to describe each pixel in the icon. 


You can generate pixmaps in UIL in two ways: 


e Define an icon inline using the ICON function (and optionally use the 
COLOR_TABLE function to specify colors for the icon). 


¢ Use the XBITMAPFILE function, specifying the name of an X bitmap 
file that you created outside UIL to be used as the pixmap value. 


In a UIL module, any argument of type pixmap should have an icon or an 
X bitmap file specified as its value. 


OR_TABLE Function 
The COLOR_TABLE function has the following syntax: 
COLOR_TABLE ( { color_expression = character },... ) 


The color expression is a previously defined color, a color defined inline 
with the COLOR function, or the phrase BACKGROUND COLOR or 
FOREGROUND COLOR. The character can be any valid UIL character 
(see Table 2-1). This function returns a value of type color_table. 


Example 2-3 shows how to specify a color table. 
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Example 2-3 Using the COLOR_TABLE Function 


VALUE 
rgb : COLOR_TABLE ( red = ’r’, green = ’g’, blue = ’b’ ); 
bitmap colors : COLOR_TABLE ( BACKGROUND COLOR = ’0’, FOREGROUND COLOR = ’1’ ); 


The COLOR_TABLE function provides a device-independent way to specify 
a set of colors. The COLOR_TABLE function accepts either previously 
defined UIL color names or inline color definitions (using the COLOR 
function). A color table must be private since its contents must be known 
by the UIL compiler in order to construct an icon. The colors within a color 
table, however, can be imported, exported, or private (see Section 3.2). 


The single letter associated with each color is the character you use to 
represent that color when creating an icon. See Section 2.5.2.2 for an 
example. Each letter used to represent a color must be unique within the 
color table. 


2.5.2.2 ICON Function 
The ICON function has the following syntax: 
ICON ( [ COLOR_TABLE = color_table_expression , ] row.,... ) 


The color table expression is a previously defined color table and the row 
is a character expression giving one row of the icon. This function returns 
a value of type pixmap. 


Example 2-4 shows how to define a pixmap using the COLOR_TABLE and 
ICON functions. 


Example 2-4 Using the ICON Function 


VALUE 
rgb : COLOR_TABLE ( red = ’=’, green = ‘0’, blue = ’ ’ ); 
x : ICON( COLOR_TABLE=rgb, fesossccos=!, 
'==0 o==!, 
'== 0 0 ==', 
'== Oo ==! 5 
'’== 0 0 ==! , 
'==0 o==', 


The ICON function describes a rectangular icon that is x pixels wide and 
y pixels high. The strings surrounded by single quotation marks describe 
the icon. Each string represents a row in the icon; each character in the 

string represents a pixel. 


The first row in an icon definition determines the width of the icon. All 
rows must have the same number of characters as the first row. The 
height of the icon is dictated by the number of rows. For example, the X 
icon defined in Example 2-4 is 9 pixels wide and 7 pixels high. 


The first argument of the ICON function (the color table specification) is 
optional and identifies the colors that are available in this icon. By using 
the single letter associated with each color, you can specify the color of 
each pixel in the icon. 
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In Example 2-4, an equal sign (=) represents the color red, a lowercase 0 
is green, and a space ( ) is blue. The icon must be constructed of characters 
defined in the specified color table. In Example 2—4, the color table named 
rgb specifies colors for the equal sign (=), lowercase 0, and space. The X 
icon is constructed with these three characters. 


A default color table is used if you omit the argument specifying the color 
table. To make use of the default color table, the rows of your icon must 
contain only spaces and asterisks. The default color table is defined as 
follows: 


COLOR_TABLE( BACKGROUND COLOR = ’ ’, FOREGROUND COLOR = ’*’ ) 


You can specify icons as either private, imported, or exported. 


2.5.2.3 XBITMAPFILE Function 


The XBITMAPFILE function is similar to the ICON function in that 
both describe a rectangular icon that is x pixels wide and y pixels high. 
However, XBITMAPFILE allows you to specify an external file containing 
the definition of an X bitmap, whereas all ICON function definitions are 
coded directly within the UIL module. The X bitmap file specified as the 
argument to the XBITMAPFILE function is read at application run time 
by DRM. 


This function returns a value of type pixmap and can be used anywhere 
a pixmap data type is expected. The XBITMAPFILE function has the 
following syntax: 


XBITMAPFILE( string_expression); 


Example 2-5 shows how to use the XBITMAPFILE function to specify a 
background pixmap. 


Example 2-5 Using the XBITMAPFILE function 


value 


background _pixmap : xbitmapfile(’myfile_ button.xbm’ ); 


FONT Function 
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In this example, the X bitmap specified in myfile_button.xbm is used 
to create a pixmap, which can be referenced by the value background_ 
pixmap. 


You define fonts with the FONT function. Using the FONT function, 
you designate a value to specify a font and then use that value for 
arguments that require a font value. The UIL compiler has no built- 
in fonts. Therefore, if you decide to specify fonts in your application 
interface, you must define all such fonts using the FONT function. This 
function returns a value of type font. 


UIL Language Syntax 
2.5 Value-Generating Functions 


Each font makes sense only in the context of a character set. The FONT 
function has an additional parameter to let you specify the character 
set for the font. This parameter is optional; if you omit it, the default 
character set is ISO_LATIN1. (See Section 2.4.1 for more information on 
character sets supported by UIL.) 


The FONT function has the following syntax: 
FONT( string-expression [, CHARACTER_SET = char-set ] ) 


The string expression specifies the name of the font (according to the 
DECwindows font naming convention) and the clause CHARACTER_SET 
= char_set specifies the character set for the font. 


Note: The string expression you use in the FONT function cannot be a 
compound string. 


Example 2-6 shows an example of the FONT function. 
Example 2-6 Using the FONT Function 





VALUE big: FONT (’ -ADOBE~-Times-Medium-R-Normal--*-140-*—-*-P-*-ISO08859-17 ); 
VALUE bold: FONT (’ -ADOBE-Helvet ica-Bold-R-Normal--*-100-*-*-P-*-IS08859-1’ ) ; 


OBJECT danger window: CAUTION _BOX 
{ ARGUMENTS 
{ TITLE = ‘You are about to lose all changes’; 
FONT ARGUMENT = FONT TABLE (bold); 
}; 
}; 


In this example, the FONT function is used with the VALUE declaration 
(described in Chapter 3) to define two fonts and give them each a name. 
One of these fonts, bold, is then converted to a font table using the 
FONT_TABLE function (since the argument font_argument requires 

a font table) and is used to specify the text font of the caution box. (See 
Section 2.5.4 for more information on the FONT_TABLE function.) 


Use the wildcard character (*) as shown in Example 2-6 to specify fonts 
in a device-independent manner. 


The VMS DECwindows Xlib Routines Reference Manual lists the names 
of fonts supported by the XUI Toolkit, and explains how font names are 
configured. 


Note: In general, you should not specify fonts for objects in your 
application interface. This allows end users to control font 
selection through the XDEFAULTS.DAT file. 


2.5.4 FONT_TABLE Function 


A font table is a sequence of pairs of fonts and character sets. When an 
object needs to display a string at run time, the object scans the font table 
for the character set that matches the character set of the string to be 
displayed. To let you supply such an argument, UIL provides the FONT_ 
TABLE function. This function returns a value of type font_table. 
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The syntax of the FONT_TABLE function is as follows: 
FONT_TABLE( font-item,... ) 

font-item ::= [ char-set = ] font-expression 

The font expression is created with the FONT function. 


The font expression specifies the name of the font (according to the 
DECwindows font-naming convention) and cannot be imported or exported. 
The optional character set specifies the character set to which this font 
applies. If you do not specify the character set, the character set specified 
in the font expression declaration is assumed. 


Note: If you specify a font value as an argument that requires a font 
table value, the UIL compiler automatically converts a font value 
to a font table. 


CLASS REC_NAME Function 


CLASS_REC_NAME is a function that specifies the class name of a 
widget. It allows you to pass a widget class name as part of an argument. 
The function returns a value type of class_rec_name. 


The CLASS_REC_NAME function has the following syntax: 
CLASS_REC_NAME(string-expression) 


Example 2—7 shows how to use the CLASS_REC_NAME function to specify 
the class of child widgets that can be added to the menu. 


Example 2-7 Using the CLASS _REC_NAME Function 


work_area_menu 
ee 
sate apenciedaa = CLASS _REC_NAME ("togglebuttongadgetclass") ; 
}; 


COMPOUND_STRING Function 


Use the COMPOUND_STRING function to set properties of a null- 
terminated string and to convert it into a compound string. The properties 
you can set are the character set and the writing direction. This function 
returns a value of type compound_string. 


The COMPOUND_STRING function has the following syntax: 
COMPOUND_STRING( string_expression [, property ]... ); 


The result of the COMPOUND_STRING function is a compound string 
with the string expression as its value. The string expression must be 
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a null-terminated string. You can optionally include one or more of the 
following clauses to specify properties for the resulting compound string: 


CHARACTER_SET = char-set 
RIGHT_TO_LEFT = boolean-expression 
SEPARATE = boolean-expression 


If you omit the character set clause, the resulting string has the same 
character set as the string expression. The character sets supported by the 
UIL are described in Section 2.4.1.2. 


The RIGHT_TO_LEFT clause sets the writing direction of the string from 
right to left if the Boolean expression is true, and left to right otherwise. 
Specifying this argument does not cause the value of the string expression 
to change. If you omit the RIGHT_TO_LEFT clause, the resulting string 
has the same writing direction as the string expression. 


The SEPARATE clause appends a separator to the end of the compound 
string if boolean-expression is true. If you omit the SEPARATE clause, the 
resulting string does not have a separator. 


You cannot use imported or exported values as the operands of the 
COMPOUND_STRING function. 


2.5.6.1 Specifying Multiline Compound Strings 
In versions of VMS higher than 5.1 (for example, 5.3 and 5.4), the 
UIL compiler does not consistently process newline characters that 
are embedded in compound strings. The effect of a newline character 
embedded in a compound string now depends solely on the character set 
specified, and the result may not always be the creation of a multiline 
compound string. 


To guarantee the creation of a multiline compound string, you must 
use the SEPARATE clause in the COMPOUND_STRING function and 
the concatenation operator (&) to join the segments into a multiline 
compound string. The SEPARATE clause takes the form SEPARATE 
= boolean-expression, and implements the newline character for VMS 
Version 5.3 and Version 5.4. For example, in VMS Version 5.1, the UIL 
compiler would generate a multiline compound string from the following 
input: 
value 

sample string : compound_string ("Hello\nWorld!"); 


To guarantee the same result in VMS Version 5.4, you must type the 
following: 


value 
sample _linel : compound_string ("Hello", separate = true); 
sample line2 : compound_string ("World!"); 
sample string : sample_linel & sample _line2; 


To retain VMS Version 5.1 behavior of the newline character in a 
compound string, compile your UIL specification file using the /VERSION 
qualifier as follows: 


$ UIL/VERSION=V1 MY _FILE.UIL 
For more information on the /VERSION qualifier, see Section 4.1.4. 
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2.5.7 COMPOUND_STRING_TABLE Function 


A compound string table is an array of compound strings. The names 
COMPOUND_STRING_TABLE and STRING_TABLE are used as 
synonyms for this function. Objects requiring a list of string values, 

such as the items and selected_items arguments for the list box widget, 
use string table values. You use the COMPOUND_STRING_TABLE 
function to build string table values. This function returns a value of type 
string_table. 


The COMPOUND_STRING_TABLE function has the following syntax: 
COMPOUND_STRING_TABLE(string_expression,... ); 


Example 2-8 shows how to use the COMPOUND_STRING_TABLE 
function. 


Example 2-8 Using the COMPOUND_STRING_TABLE Function 


object file privileges: list_box 
{ arguments 

{ items = string_table( "owner read", 
“owner write", 
“owner delete", 
"system read", 
"system write", 
“system delete", 
“group read", 
“group write", 
"group delete" ); 

selected_items = string _table 
( "owner read", 

"owner write", 
"system read", 
"system write" );. 


Example 2-8 creates a list box with nine menu choices. Four of the choices 
are initially displayed as having been selected. 


The strings inside the string table can be simple strings, which the UIL 
compiler automatically converts to compound strings if the strings are 
declared as null-terminated strings.. 


2.5.8 ASCIZ_STRING_TABLE Function 


An ASCIZ string table is an array of ASCIZ (null-terminated) string values 
separated by commas. The names ASCIZ_TABLE and ASCIZ_STRING_ 
TABLE are used as synonyms for this function. The ASCIZ_STRING_ 
TABLE function allows you to pass more than one ASCIZ string as a 
callback tag value. This function returns a value of type asciz_table. 


The ASCIZ_STRING_TABLE function has the following syntax: 
ASCIZ_STRING_TABLE( asciz_string_expression,... ); 
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Example 2-9 shows how to use the ASCIZ_STRING_TABLE function to 
specify a callback tag. 


Example 2~9 Using the ASCIZ_STRING_TABLE Function 


value 
valuel = "my value_1"; 
value2 = "my value _2"; 
value3 = "my value_3"; 
object press_my: push_button { 
arguments { 
height = 30; 
width = 10; 
}; 
callbacks { 
activate = procedure my_callback(asciz_table(valuel, value2, value3)); 


}e 
}; 


INTEGER_TABLE Function 


An integer table is an array of integer values separated by commas. The 

INTEGER_TABLE function allows you to pass more than one integer tag 
value per callback reason. This function returns a value of type integer_ 
table. 


The INTEGER_TABLE function has the following syntax: 
INTEGER_TABLE( integer_expression,... ); 


Example 2—10 shows how to use the INTEGER_TABLE function to define 
an array of integers to be passed as a callback tag to the procedure | 
my_callback. 


Example 2-10 Using the INTEGER_TABLE Function 


value 
valuel = "my value_1"; 
value2 = "my value 2"; 
value3 = "my_value_3"; 


object press _my: push_button { 
arguments  { 
height = 30; 
width = 10; 
}; 
callbacks { 
activate = procedure my_callback (integer table(valuel, value2, value3)); 
}; 
}; 
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2.5.10 ARGUMENT Function 


The ARGUMENT function defines the arguments to a user-defined 
widget. Each of the objects that can be described by UIL permits a set 
of arguments, listed in Appendix B. For example, height is an argument 
to most objects and has integer data type. To specify height for a user- 
defined widget, you can use the built-in argument name height, and 


specify an integer value when you declare the user-defined widget. You do 
not use the ARGUMENT function to specify arguments that are built into 


the UIL compiler. 
The ARGUMENT function has the following syntax: 
ARGUMENT( character_expression [, argument_type ] ) 


In this syntax, character_expression is the name the UIL compiler uses 


for the argument in the UID file, while argument_type is the type of 
value that can be associated with the argument. If you omit the second 


argument, the default type is ANY and no value type checking occurs. Use 


one of the following keywords to specify the argument type: 


ANY 

ASCIZ_TABLE 
BOOLEAN 
CLASS_REC_NAME 
COLOR 
COLOR_TABLE 
COMPOUND_STRING 
FLOAT 

FONT 

FONT_TABLE 

ICON 

INTEGER 
INTEGER_TABLE 
REASON 

STRING 
STRING_TABLE 
TRANSLATION_TABLE 


For example, suppose you built a user-defined widget that draws a 
circle and takes four arguments: my_radius, my_color, x, and y. | 
Example 2-11 shows how to use the ARGUMENT function to define 
the arguments to this user-defined widget. Note that the ARGUMENT 
function is not used to specify arguments x and y because these are 
built-in argument names. The data type of x and y is integer. 
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When you declare the circle widget, you must use the ARGUMENT 
function to define the name and data type of the arguments that are 

not built-ins (my_radius and my_color). Arguments are specified in an 
arguments list, identified by the keyword ARGUMENTS in Example 2-11. 
(See Section 3.5.1 for more information on arguments lists.) 


Example 2-11 Using the ARGUMENT Function 





OBJECT circle: 
USER_DEFINED PROCEDURE CircleCreate 


{ ARGUMENTS 
{ ARGUMENT( ‘’my_ radius’, INTEGER ) = 1000; 
ARGUMENT (. ’my_color’, COLOR) = color_blue; 
x = 1050; 
y = 1050; 


}3 
}e 


The following UIL source code is equivalent to that shown in 
Example 2-11: 


VALUE circle radius: ARGUMENT( ’my_ radius’, INTEGER ); 
VALUE circle color: ARGUMENT( ‘my color’, COLOR ); 


OBJECT circle: 
USER_DEFINED PROCEDURE CircleCreate 
{ ARGUMENTS 


{ circle radius = 1000; 
circle_color = color blue; 
x = 1050; 

y = 1050; 


}; 

}e 
In this example, the ARGUMENT function is used in a value declaration 
(described in Chapter 3) to define the two arguments that are not UIL 
built-ins: circle_radius and circle_color. The first of these arguments takes 
an integer value; the second takes a color value. When referenced in the 
arguments list of the circle widget, the UIL compiler verifies that the 
value you specify for each of these arguments is of the type specified in 
the ARGUMENT function. An example of the arguments list placed in the 
UID file (and supplied to the creation routine for the circle widget at run 
time) is given in Table 2-12. 


Table 2-12 Values for ARGUMENT Function 





Argument Argument Value 
my_radius 1000 
my_color Value associated with the UIL name color_blue 


You can also use the ARGUMENT function to allow the UIL compiler to 
recognize extensions to the XUI Toolkit. For example, an existing widget 
may accept a new argument. Using the ARGUMENT function, you can 
make this new argument available to the UIL compiler before the updated 
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version of the compiler i is released. ‘Section 3.9 shows an example of this 
use of the ARGUMENT function. 


The VMS DECwindows Guide to Application Programming explains 
how to build and use user-defined widgets in UIL, and shows how DRM 
constructs the run-time data structures associated with user-defined 
arguments. | 


2.5.11 REASON Function 


Each of the objects in the XUI Toolkit defines a set of conditions under 
which it calls a user-defined function. These conditions are known 

as callback reasons. The user-defined functions are termed callback 
procedures. In a UIL module, you use a callbacks list to specify which 
user-defined functions are to be called for which reasons. 


The REASON function is useful for defining new reasons for user-defined 
widgets. When you declare a user-defined widget in UIL, you can define 
callback reasons for that widget using the REASON function. This 
function returns a value of type reason. The REASON function has 

the following syntax: 


REASON( character_expression ) 


The character expression specifies the argument name stored in the UID 
file for the reason. This reason name is supplied to the low-level widget 
creation routine at run time. 


Appendix B lists the callback reasons supported by the XUI Toolkit objects. 


Suppose you built a new widget that implements a password system 
to prevent a set of windows from being displayed unless a user enters 
the correct password. The widget might define the callbacks shown in 
Example 2-12. 


Example 2-12 Using the REASON Function 


OBJECT guard_post: USER_ DEFINED PROCEDURE guard_post_create 


{ CALLBACKS 
{ REASON( ’AccessGrantedCallback’ ) = PROCEDURE display next_level(); 
REASON ( ‘’AccessDeniedCallback’ ) = PROCEDURE logout (); 


}e 
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The following UIL source. code is equivalent to that shown in 
Example 2-12: 


VALUE passed: REASON( ’AccessGrantedCallback’ ); 
VALUE failed: REASON( ’AccessDeniedCallback’ ); 


OBJECT guard post: USER_DEFINED PROCEDURE guard _post_create 
_ { CALLBACKS 
{ passed = PROCEDURE display _next_level(); 
failed = PROCEDURE logout () }; 
}; 
}3 


UIL Language Syntax 
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In this example, the REASON function is used in a value declaration to 
define two new reasons, passed and failed. The callback list of the widget 
named guard_post specifies the procedures to be called when these reasons 
occur. 


A widget specifies its callbacks by defining a low-level argument for each 
reason that it supports. The argument to the REASON function gives 
the name of the low-level argument that supports this reason. Therefore, 
the low-level argument list placed in the UID file for the widget named 
guard_post includes the arguments arguments listed in Table 2-13: 


Table 2-13 Specifying Callbacks Using the REASON Function 


Argument Name _ Argument Value 
AccessGrantedCallback | Callback structure for display_next_level 
| _ OO Pag 8 procedure 
'  AccessDeniedCallback | ___ Callback structure for logout procedure 





| The VMS DECwindows Guide to Application Programming shows how 
DRM constructs the run-time data structures associated with user-defined 
‘reasons (which ¢ are widget eae in the XUI Toolkit). 


2.5. 12 TRANSLATION. TABLE Function 


Each of the XUI Toolkit widgets has a translation table that maps events 
(for example, the left. mouse button was pressed) to a sequence of actions. 
_ Through widget arguments, such as the translations argument, you can 
_ specify an alternate set of events or actions for a particular widget. 


The TRANSLATION_TABLE function creates a translation table that can 
_be used as the value of an argument that is of the data type translation_ 

table. This function returns a value of type translation_table. The 

TRANSLATION_TABLE function has the following syntax: 


TRANSLATION_TABLE( character_expression,... ) 


Each of the character expressions specifies the run-time binding of an 

. X-level event to a sequence of actions, as shown in Example 2-13. Each of 
these actions is associated with a procedure that will be executed at run 
time. Argument lists are discussed in Section 3.5.1. 


Example 2-13 defines an argument list called new_translations. This 
arguments list contains the definition of a. translation table which is 
specified as the value for the translations argument. 


- The first line of the definition is a translation table directive that indicates 
the current translations are to be overridden with those specified in 
the translation table. In this example, the translations defined by new_ 
transiations will override the current translations for the self_destruct 

_ push button. 
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You can use one of three translation table directives with the 
TRANSLATION_TABLE function: #override, #augment, or #replace 
(which is the default). If used, the directive must be the first entry in 
the translation table, as shown in Example 2-13. Appendix D of the 
VMS DECwindows Guide to Application Programming provides more 
information on translation tables. 


The #override directive causes any duplicate translations to be ignored. 
For example, if <Btnl Down> is already defined in the current translations 
for a push button, the translation table defined in new_translations 
overrides the current definition. If the #augment directive had been 
specified, the current definition for <Btnl1 Down> takes precedence over the 
definition given in new_translations. The #replace directive replaces all 
current translations with those specified in the translations argument. 


Example 2-13 Using the TRANSLATION_TABLE Function 





LIST new_translations: 


ARGUMENTS 
{ TRANSLATIONS 


TRANSLATION TABLE 


( 
'#toverride’ 
‘<BtnlDown>: 
‘<BtnlUp>: 


‘<Btn3Up>: 


DWTPBFILLHIGHLIGHT() DWTPBARM() DWTPBUNGRAB()’, 
DWTPBFILLUNHIGHLIGHT() DWTPBACTIVATE() \ 
selection(self destruct) DWTPBDISARM()’, 
DWTPBHELP ()’, 


‘Any<LeaveWindow>: DWTPBFILLUNHIGHLIGHT() DWTPBUNGRAB() DWTPBDISARM()’ 


ye 
}e 


OBJECT self destruct: push_button 


{ ARGUMENTS 


{ ARGUMENTS new_translations; }; 


he 
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The purpose of the ANY data type is to shut off the data type-checking 
feature of the UIL compiler. You can use the ANY data type for the 
following: 


e Specifying the type of a callback procedure tag 
e Specifying the type of a user-defined argument 


You can use the ANY data type when you need to use a type not supported 
by the UIL compiler or when you want the data type restrictions imposed 
by the compiler to be relaxed. For example, you might want to define 

a widget having an argument that can accept different types of values, 
depending on run-time circumstances. 
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If you specify that an argument takes ANY value, the UIL compiler does 
not check the type of the value specified for that argument; therefore, you 
need to take care when specifying a value for an argument of type ANY. 
You could get unexpected results at run time if you pass a value having a 
data type that the widget does not support for that argument. 


2.7 Include File for Useful Constants 


For each of the bindings, there is a file containing useful constants for 
specifying objects in UIL. Include one of the files in Table 2-14 in your 
-UIL module to have access to the constants. 


Table 2-14 UIL Include File Bindings 


Binding File Specification 
VAX binding SYS$LIBRARY:DECW$DWTDEF.UIL 
MIT C binding DECw$include:DwtAppl.uil 


For example, the file DECw$Include:DwtAppl.uil contains the definition of 
the constant DwtOrientationVertical. You can use this constant for objects 

_ that have an orientation argument (such as the scroll bar and separator). 
In the file SYS$LIBRARY:DECW$DWTDEF.UIL, this same constant is 
named DWT$C_ORIENTATION_VERTICAL. 


2.8 Compile-Time Value Expressions 


UIL provides literal values for a diverse set of types (integer, string, real, 
and Boolean) and a set of VMS DECwindows-specific types (for example, 
colors and fonts). These values are used to provide the value of XUI 
Toolkit arguments. — | 


UIL allows compile-time value expressions. These expressions can contain 
references to other UIL values but cannot be forward referenced. 


Compile-time value expressions are useful for implementing relative 
positioning of children without using the attached_dialog_box object type. 
For example, suppose you want to create a message box inside a dialog 
box, and you want the message box to be half as wide and half as tall as 
the dialog box, and centered within it. Using compile-time expressions, 
you can specify the coordinates of the message box by referring to the 
values you already defined for the dialog box. If you do not use compile- 
time value expressions in this case, you would have to compute the x and 
y location and the height and width of the message box, and recompute 
these values if the dialog box changes size or location. Furthermore, 

the computed values would be absolute numbers rather than descriptive 
expressions like "dialog_box_width / 2". 


Note that this example is valid as long as the units argument for the 
dialog box is set to pixels; the width and height of a dialog box are 
expressed in pixels, but the default unit of measure for positioning 
within a dialog box is font units. If you do not specify that position 
argument values (x or y) are expressed in pixels rather than font units, 


2-31 


2.8.1 


UIL Language Syntax 
2.8 Compile-Time Value Expressions 


expressions using the value of width or height to compute position might 
give unexpected results. 


You can also use compile-time expressions to maintain spacing between 
objects in a device-independent manner. (The actual measurement of a 
font unit differs between 75-dpi and 100-dpi monitors.) For example, you 
can maintain the spacing between a list box and its label by using the 
following value and object declarations: 


VALUE k_delta_y: 11; 
k_y : 200; 


OBJECT listbox_label: LABEL 
{ ARGUMENTS { listbox_label_y = k_y; }; 
he 
OBJECT my_listbox: LIST _BOX 
{ ARGUMENTS { listbox_y = k_y + k_delta_y; }; 
}; . 


In this example, the list box is always 11 font units below its label, 
regardless of where the label is positioned. Because the height of a label 
is determined by the height of the font used to display the text of the 
label (as long as the label object’s conform_to_text argument is true), 
you could consider the height of a label to be one (vertical) font unit. 
Therefore, you obtain roughly the same result regardless of the size of a 
font unit. 


The concatenation of strings is also a form of compile-time expression. 
Use the concatenation operator to join strings and convert the result to a 
compound string. 


Operators 


Table 2-15 lists the set of operators in UIL that allow you to create 
integer, real, and Boolean values, and to concatenate strings based on 
other values defined with the UIL module. 


Table 2-15 UIL Operators 








Operator 
Operator Type Operand Types Meaning Precedence 
~ Unary Boolean NOT 1 (highest) 
integer 1’s complement 1 
i Unary float negate 1 
integer negate 1 
+ Unary float no-op 1 
integer no-op 1 
' Binary float, float multiply 2 
integer, integer multiply 2 





(continued on next page) 
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Table 2-15 (Cont.) UIL Operators 





Operator 
Operator Type 
/ Binary 
+ Binary 
- Binary 
>> Binary 
<< Binary 
—& Binary 
Binary 
. Binary 


Operand Types Meaning Precedence 
float, float divide 2 
integer, integer divide 2 
float, float add 3 
integer, integer add 3 
float, float subtract 3 
integer, integer subtract 3 
integer, integer shift right 4 
integer, integer shift left 4 
Boolean, Boolean AND 5 
integer, integer bitwise AND 5 
string! concatenation 5 
Boolean, Boolean OR 6 
integer, integer bitwise OR 6 
Boolean, Boolean XOR 6 
6 


integer, integer bitwise XOR 





'String can be either a simple compound string or a sequence of compound strings. If the two concatenated strings have 
different properties (such as writing direction or character set), the result of the concatenation is a sequence of compound 


strings. 





Note: 


The result of each operator has the same type as its operands. Note that 
you cannot mix types in an expression without using conversion routines. 


You can use parentheses to override the normal precedence of operators. 


In a sequence of unary operators, the operations are performed in right-to- 
left order. For example, — + —A is equivalent to —+(—A)). 


In a sequence of binary operators of the same precedence, the operations 


are performed in left-to-right order. For example, A*B/C*D is equivalent 
to ((A*B)/C)*D. 


A value declaration gives a value a name. You cannot redefine the value of 
that name in a subsequent value declaration. 


You can use a value containing operators and functions anywhere you can 
use a value in a UIL module. 


You cannot use exported or imported values as operands in 
expressions. 


2.8.2 Data Type Conversion in Expressions 


Several of the binary operators are defined for multiple data types. For 
example, the operator for multiplication (*) is defined for both floating- 


- point and integer operands. For the UIL compiler to perform these 


binary operations, both operands must be of the same type. If you supply 
operands of different data types, the UIL compiler automatically. converts 
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one of the operands to the type of the other according to the conversion 


rules listed in Table 2-16. 


Table 2-16 Automatic Data Type Conversions in UIL 


Data Type of Data Type of 
Operand 1 Operand 2 
Boolean Integer 
Integer Boolean 
Integer Floating point 
Floating point Integer 


Conversion Rule 


Operand 1 converted to integer 
Operand 2 converted to integer 
Operand 1 converted to floating point 
Operand 2 converted to floating point 


You can also explicitly convert the data type of a value by using one of the 


functions in Table 2-17. 


Table 2-17 UIL Data Type Conversion Functions 


Function Result 


INTEGER(boolean) Integer 
INTEGER(integer) Integer 
INTEGER (float) Integer 


FLOAT(boolean) Floating point 
FLOAT (integer) Floating point 


FLOAT (float) Floating point 
COMPOUND_ Compound string 
STRING(string) 


Comment 


TRUE—1, FALSE—0 
No effect 


Integer part of the floating-point 
number (truncate toward zero) can 
result in overflow 


TRUE-—1.0, FALSE--0.0 


Floating point representation of 
integer; should not be any loss of 
precision 


No effect 


Converts string to a compound 
string; no effect if string is already a 
compound string 





Example 2-14 shows a value section from a UIL module containing 
compile-time expressions and data conversion functions. 


UIL Language Syntax 
2.8 Compile-Time Value Expressions 


Example 2-14 Compile-Time Expressions in a UIL Module — 





VALUE 
outer_box_width: 
outer _box_height: 
box_size ratio: 


inner_box_width: 
inner_box_height: 
inner _box_x: 
inner _box_y: 

type field: 
class_field: 
typel: 


type2: 
type3: 


classl: 
class2: 
class3: 


combol: 


box_name: 
box_help_key: 


200; 
250; 
0.5; 


INTEGER( outer_box_ width * box_size_ratio ); 
INTEGER( outer_box_height * box size ratio ); 
(outer _box_width - inner_box_width) >> 1; 
(outer box_height - inner _box_height) / 2; 


0; 
16; 
1; 
2; 
3; 


1; 
23 
3; 
(typel << type. field) | (class3 << class field); 


"My Box’; ! Null-terminated string 
COMPOUND _STRING(’Help’); !Compound string 
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3 UIL Module Structure 


This chapter describes the structure of a UIL module, explains the scope of 
references to values and objects defined in UIL, and describes the syntax 
and use of the following UIL module components: 


¢ Value section 

e Procedure section 
e List section 

e Object section 

¢ Identifier section 


¢ Include directive 


In addition, this chapter describes the following features of UIL: 
¢ Definitions for constraint arguments 


¢ Symbolic references to widget identifiers 


Note: In this chapter, all examples assume case-insensitive mode. 
Keywords are shown in uppercase letters to distinguish them 
from user-specified names, which are shown in lowercase letters. 
This use of uppercase letters is not required in case-insensitive 
mode. In case-sensitive mode, keywords must be in lowercase 
letters. 


3.1 Structure of a UIL Module 


A UIL module contains definitions of objects that are to be stored in 
a User Interface Definition (UID) file. A UIL module consists of a 

~ module block, which begins with the keyword MODULE and ends with 
the keywords END MODULE. A module block contains a series of value, 
procedure, list, identifier, and object sections. There can be any number 
of these sections in a UIL module. A UIL module can also contain one 
or more include directives, which can be placed anywhere in the module 
except within a value, procedure, list, identifier, or object section. 


The structure of a UIL module is as follows: 


uil_module ::= 
MODULE module_name 
[ version_clause ] 
[ case_sensitivity_clause ] 
{ default_character_set_clause ] 
[ default_object_variant_clause ] 
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value_section 
procedure_section 
list_section 
identifier_section 
object_section 
include_directive }... 
END MODULE ";" 


version_clause ::= 
VERSION "=" character_expression 


eee ee 


case_sensitivity_clause ::= 
NAMES "=" { CASE_SENSITIVE 
CASE_INSENSITIVE } 


default_character_set_clause ::= 
-CHARACTER_SET "=" char-set 


default_object_variant_clause ::= 
OBJECTS “=" "{" object_type "=" {WIDGET | GADGET}";”..."}" 


The module name is the name by which this UIL module is known in the 
UID file. This name is stored in the UID file for later use in the retrieval 
of resources by the XUI Resource Manager (DRM). This name is always 
stored in uppercase in the UID file. 


Example 3-1 shows the structure of a typical UIL module. 
Example 3~1 UIL Module Structure 





MODULE example ! module name (stored as EXAMPLE in UID file) 
VERSION = ‘V2.0’ ! version of this module 
NAMES = CASE_INSENSITIVE ! keywords and names are not case sensitive 


CHARACTER_SET = ISO LATING ! default character set is ISO_LATING6 
OBJECTS = { push_button = GADGET; } ! push buttons are gadgets by default 


! Declare the VALUES, PROCEDURES, LISTS, and OBJECTS 
! here.. 
{— 


END MODULE; 





The clauses on the module header are described in the following sections. 


Version Clause 


The version clause specifies the version number of the UIL module. 
Identify a version clause with the keyword VERSION. The version clause 
is provided so that an application can guarantee that it is using the correct 
version of a UIL module. The character expression you use to specify the 
version can be up to 31 characters in length. In Example 3—1; the version | 
number is V2.0. 
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3.1.2 Case-Sensitivity Clause 


The case-sensitivity clause indicates whether user-specified names in 

the UIL module are to be treated as case sensitive or case insensitive. 
For example, if names are case sensitive, then the names “sample” and 
“Sample” would refer to different components in the UIL module. If names 
are case insensitive, then “sample” and “Sample” would be treated as 

the same name and could be used interchangeably to refer to a single 
component. The default is case insensitive. 


Identify a case-sensitivity clause with the keyword NAMES. The case- 
sensitivity clause must precede any statements that include a user- 
specified name. 


If names are case sensitive in a UIL module, UIL keywords in that module 
must be in lowercase. Each name is stored in the UID file in the same 
case as it appears in the UIL module. If names are case insensitive, then 
keywords can be in uppercase, lowercase, or mixed case, and the uppercase 
equivalent of each name is stored in the UID file. Table 3-1 summarizes 
these rules. 


Table 3-1 Rules for Case Sensitivity in a VIL Module 


Keyword Treatment in UIL : 
Case Sensitivity Module _ Name Treatment in UID File 





Case sensitive Must be entered in lowercase Names are stored in the same 
case as they appear in the UIL 
module 


Case insensitive Can be entered in lowercase, Names are stored in uppercase 
uppercase, or mixed case 


3.1.3 Default Character Set Clause 


The default character set clause specifies the default character set for 
string literals in the module. Identify the default character set clause 
with the keyword CHARACTER_SET. The use of the default character set 
clause is optional. 


If specified, the character set clause designates the character set used to 
interpret an extended string literal if you did not specify a character set for 
that literal. If you do not include the character set clause in the module 
header, the default character set for the compilation is ISO_LATIN1. In 
Example 3-1, the default character set for the module is ISO_LATIN6. 


3.1.4 Default Object Variant Clause 


The default object variant clause begins with the keyword OBJECTS. 
Some objects can be either widgets or gadgets. In the object variant 
clause you list these objects, and specify whether they will be used as a 
widget or a gadget in this module. A gadget is a simplified version of a 
widget that consumes fewer resources (and therefore enhances application 
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performance) but offers limited customization. The following types of user 
interface objects have both a widget and a gadget variant: 


¢ Label 

¢ Pull-down menu entry 
¢ Push button 

¢ Separator 


¢ Toggle button 


For the most part, the widget and gadget variants are interchangeable. To 
use gadgets in your application, you need to specify to the UIL compiler 
that you want that particular variant. Otherwise, by default, the UIL 
compiler assumes you want to use widgets. There are two ways you can 
specify that you want to use a gadget instead of a widget: You can add 

a default object variant clause to the module header; or you can add the 
keyword GADGET to particular object declarations (see Section 3.6). 


By using the default object variant clause in the UIL module header, you 
can declare all labels, pull-down menu entries, push buttons, separators, 
and toggle buttons, or any combination of these types, to be gadgets. In 
Example 3-1, only push buttons are declared as gadgets. 


To change these objects from one variant to the other, you need only 
change the default object variant clause. For example, suppose you used 
the default object variant clause to declare all push buttons as gadgets. 
To change push button objects from gadgets to widgets, remove the push 
button type from the clause. 


See Section 3.6 for more information on specifying the variant of objects in 
a UIL module. 


3.2 Scope of References to UIL Objects and Values 


Resources specified in VALUE or OBJECT sections in a UIL module can 
have one of the following levels of privacy, or scope: 


e Exported—A value or object that you define as exported is stored in 
the UID file as a named resource, and therefore can be referenced by 
name in other UID files, or can be fetched from the UID file by the 
application using DRM literal fetching routines. An exported value 
or object in UIL is similar to a global variable in a programming 
language. 


¢ Imported—A value or object that you define as imported is one that is 
defined as a named resource in a UID file. DRM resolves this value 
or object declaration with the corresponding exported declaration at 
application run time. When you define a value or object as imported, 
DRM looks outside the module in which the imported value or object 
is declared to get its value at run time. Imported objects do not accept 
any arguments, controls, or callbacks. 
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¢ Private—A private value or object is not imported or exported. A value 
or object that you define as private is not stored as a distinct resource 
in the UID file. You can reference a private value or object only in 
the UIL module containing the declaration. The value or object is 
directly incorporated into anything in the UIL module that references 
the declaration. A private value or object in UIL is similar to a local 
variable in a programming language. 


Importing resources is not the same as including resources from another 
file. The INCLUDE FILE directive (described in Section 3.8) places in line 
the contents of the specified include file. When you use the INCLUDE 
FILE directive in a UIL module, the resulting UID file is identical to the 
one you would obtain if you did not use the INCLUDE FILE directive, but 
instead directly specified that information in the UIL module. To change 
an included value, you need to recompile the UIL module. 


Importing resources is useful for changing the value of the resource at 
run time. When you specify a resource as imported, the UID file does not 
contain the actual value; only the name and data type of the resource are 
stored. The resource value is not resolved until run time. Since the value, 
as well as its name and data type, would be stored in the UID file when 
the UIL module contains only private resources, the UID files would not 
be identical in this case. 


EXPORTED, IMPORTED, and PRIVATE are reserved UIL keywords. By 
default, values and objects are private. 


3.3. Structure of a Value Section 


A value section consists of the keyword VALUE followed by a sequence of 
value declarations, as follows: 


value_section = _ 
VALUE value_decliaration... 


value_decliaration ::= 
value_name ":" 
{ EXPORTED value_expression | 
| PRIVATE value_expression 
| value_expression 
_| IMPORTED value_type } ";" 


A value declaration provides a way to name a value expression. The 
value name can be referred to by declarations which occur later in the 
UIL module in any context where a value can be used. Values cannot be 
forward referenced; you must declare a value name before you reference 
that name. 


Value sections can include a clause defining the privacy level for the value. 
See Section 3.2 for more information about privacy levels in UIL. 


Table 3-2 describes the supported value types in UIL. 
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Table 3-2 UIL Value Types 


Value Type 
ANY 


ARGUMENT 
ASCIZ_TABLE 
BOOLEAN 


CLASS_REC_NAME 
COLOR 
COLOR_TABLE 


COMPOUND_STRING 
FLOAT 

FONT 

FONT_TABLE 


INTEGER 
INTEGER_TABLE 
PIXMAP 


REASON 


STRING 
STRING_TABLE 


TRANSLATION_TABLE 


Description 


Prevents the UIL compiler from checking 
the type of an argument value or callback 
procedure tag value 


Defines a value as a user-defined argument 
Defines a value as an array of ASCIZ 


Defines a value as TRUE (ON) or FALSE 
(OFF) 


Defines a value as a class record name 
Defines a value as a color 


Provides a device-independent way to define 
a set of colors (usually for a pixmap) 


Defines a value as a compound string 
Defines a value as a floating point literal 
Defines a value as a font 


Defines a value as a sequence of font and 
character set pairs 


Defines a value as an integer 
Defines a value as an array of integers 


Describes a rectangular pixmap using a 
character to represent each pixel 


Defines a condition under which an object is to 
call an application function 


Defines a value as a primitive string 


Defines a value as an array of compound 
strings 

Defines an alternative set of events or actions 
for a widget 


Example 3-2 shows how to declare values. 
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Example 3-2 UIL Value Declaration 


VALUE 
k_main : EXPORTED 1; 
k_main_menu : EXPORTED 2; 
k_main_command : EXPORTED 3; 
VALUE 
white : IMPORTED COLOR; 
blue : IMPORTED COLOR; 
arg_name : PRIVATE ’new_argument_name’; 
VALUE 
main_prompt : ‘next command’; ! PRIVATE by default 
main font : IMPORTED FONT; 


Because the values k_main, k_main_menu, and k_main_command are 
defined as exported and are integers, you can use these values in another 
UIL module as follows: 


VALUE 
k_main : IMPORTED integer; 





3.4 Structure of a Procedure Section 


A procedure section consists of the keyword PROCEDURE followed by a 
sequence of procedure declarations, as follows: 


procedure_section ::= 
PROCEDURE procedure_deciaration... 


procedure_declaration ::= 
procedure_name 
[ formal_parameter_spec ]";" 


formal_parameter_spec ::= 
"(" [ value_type ] ")" 


Use a procedure declaration to declare a routine that can be used as 

a callback routine for an object or as the creation routine for a user- 
defined widget (see Example 2-12). You can reference a procedure name 
in declarations that occur later in the UIL module in any context where 
a procedure may be used. Procedures cannot be forward referenced; you 
must declare a procedure name before you reference it. You cannot use a 
name you used in another context as a procedure name. 


In a procedure declaration, you have the option of specifying that a 
parameter will be passed to the corresponding callback routine at run 
time. (This parameter is called the callback tag.) You can specify the data 
type of the callback tag by putting the data type in parentheses following 
the procedure name. When you compile the module, the UIL compiler 
checks that the argument you specify in references to the procedure is of 
this type. Note that the data type of the callback tag must be one of the 
valid UIL value types (see Table 3-2). 
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If you explicitly include a parameter specification in the procedure 
declaration, the UIL compiler checks the argument type when the 
procedure is referenced. For example, in the following procedure 
declaration, the callback procedure named toggle_proc will be passed 

an integer tag at run time. The UIL compiler checks that the parameter 
specified in any reference to procedure toggle_proc is an integer. 


PROCEDURE 
toggle _proc (integer) ; 


While it is possible to use any UIL data type to specify the type of a tag 
in a procedure declaration, you must be able to represent that data type | 
in the high-level language you will be using to write your application 
program. Some data types (such as integer, boolean, and string) are 
common data types recognized by most programming languages. Other 
UIL data types (such as string tables) are more complicated and may 
require you to set up an appropriate corresponding data structure in the 
application in order to pass a tag of that type to a callback procedure. 


Table 3-3 summarizes how the UIL compiler checks argument type and 
argument count, depending on the procedure declaration. 
Table 3-3 UIL Compiler Rules for Checking Argument Type and Count 


Declaration Description of Rule 





No parameters No argument type or argument count checking occurs. You can 
supply one argument or no arguments in the procedure reference. 


() Checks that the argument count is zero. 


(ANY) Checks that the argument count is one. Does not check the 
argument type. Use the ANY type to prevent type checking on 
procedure tags. 


(value_type) Checks for one argument of the specified value type. 





You can also use a procedure declaration to specify the creation routine 
for a user-defined widget. In this case, you specify no formal parameters. 
The procedure is invoked with the standard four arguments passed to all 
low-level widget creation routines. (See the VMS DECwindows Toolkit 
Routines Reference Manual for more information about low-level widget 
creation routines.) 


Example 3-3 shows how to declare procedures. 


UIL Module Structure 
3.4 Structure of a Procedure Section 


Example 3-3 UIL Procedure Declaration 





PROCEDURE 
app help (INTEGER) ; 
app_destroy (INTEGER) ; 





Structure of a List Section 


A list section consists of the keyword LIST followed by a sequence of list 
declarations, as follows: 


list_section ::= 
LIST list_declaration... 


list_declaration ::= 


list_name ":" list_definition ";" 
list_definition ::= 

list_type list_spec 
list_type <= 

{ ARGUMENTS 

| CALLBACKS 

| CONTROLS 

| PROCEDURES } 
list_spec ::= 

{ list_name 

| "{" list_entry... "}" } 
list_entry 


{ list_definition 

| argument_list_entry 

| control_list_entry 

| callback_list_entry } ";" 


You use lists to group together a set of arguments, controls (children), or 
callbacks for later use in the UIL module. Lists can contain other lists, so 
that you can set up a hierarchy to clearly show which arguments, controls, 
and callbacks are common to which objects. You cannot mix the different 
types of lists; that is, a list of a particular type cannot contain entries of a 
different list type or reference the name of a different type of list. 


A list name is always private to the UIL module in which you declare the 
list and cannot be stored as a named resource in a UID file. 


There are three types of UIL lists, as follows: 

e Arguments list, having the list type ARGUMENTS 
¢ Callbacks list, having the list type CALLBACKS 

¢ Controls list, having the list type CONTROLS 


These list types are described in the following sections. 
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3.5.1 


UIL Module Structure 
3.5 Structure of a List Section 


Arguments List Structure © 
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An arguments list defines which arguments are to be specified in the 
argument list parameter when the creation routine for a particular object 
is called at run time. An arguments list also specifies the values for those 
arguments. Each arguments list entry has the following syntax: 


argument_list_entry ::= 
argument_name "=" value_expression 


The argument name must be either a built-in argument name or a user- 
defined argument name that is specified by using the ARGUMENT 
function (see Section 2.5.10). If you use a built-in argument name, the 
type of the value expression must match the allowable type for this 


argument. 


If you use a built-in argument name as an arguments list entry in an 
object definition, the UIL compiler checks the argument name to be sure 
that it is supported by the type of object that you are defining. If the same 
argument name appears more than once in a given arguments list, the last 
entry that uses that argument name supersedes all previous entries with 
that name, and the compiler issues a diagnostic message. 


Some arguments are coupled by the UIL compiler. When you specify one 
of the arguments, the compiler also sets the other. The coupled argument 
is not available to you. The coupled arguments are listed in Table 3—4. 


Table 3-4 UiL Coupled Arguments 


Supported Argument Coupled Argument 
items items_count 
selected_items selected_items_count 


See Appendix B for information about supported arguments, their data 
types, and default values for each widget in the XUI Toolkit. 


Example 3—4 shows how to declare an arguments list. 


__ UIL Module Structure 
3.5 Structure of a List Section 


Example 3-4 UIL Arguments List Declaration 


LIST 

default size: ARGUMENTS { 
HEIGHT = 500; 
WIDTH = 700; 

}; 

default_args: ARGUMENTS { 
ARGUMENTS default_size; 
FOREGROUND_COLOR = white; 
BACKGROUND_COLOR = blue; 

}; 


3.5.2 Callbacks List Structure 


Use a callbacks list to define which callback reasons are to be processed by 
a particular object at run time. Each callbacks list entry has the following 
syntax: 


callback_list_entry ::= 
reason_name "=" procedure_reference 


procedure_reference ::= 
PROCEDURE procedure_name 
[{ "(" [ value_expression ] ")" ] 


A UIL built-in reason maps to a callback argument in the XUI Toolkit. 
For XUI Toolkit objects, the reason must be a built-in reason. For a user- 
defined widget, you can use a reason that you previously declared using 
the REASON function (see Chapter 2). If you use a built-in reason in an 
object definition, the UIL compiler ensures that the reason is supported by 
the type of object you are defining. Appendix B contains information about 
which callback reasons are supported by which objects. 


If the same reason appears more than once in a callbacks list, the last 
entry that uses that reason supersedes all previous entries using that 
reason, and the UIL compiler issues a diagnostic message. 


You must have previously declared the procedure name you use in a 
callbacks list. If you specified a value for the callback tag, the tag 
type must match the value type of the parameter in the corresponding 
procedure declaration. See Section 3.4 for a detailed explanation of 
argument type checking for procedures. 


Example 3-5 shows how to declare a callbacks list. 
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UIL Module Structure | 
3.5 Structure of a List Section 


Example 3-5 UjiL Callbacks List Declaration 





LIST 
default callbacks : CALLBACKS { 
destroy PROCEDURE app_destroy (k_main); 
help PROCEDURE app_help (k_main); 


tt 


}e 





The following lines of pseudocode show the interface to the callback 
procedure: 


PROCEDURE BEOPean eS name ( widget by reference, 


tag by reference, 
object-specific structure by reference ) 


> no value; 


Since the UIL compiler produces a UID file rather than an object module | 
(.OBJ), the binding of the UIL name to the address of the entry point 

to the procedure is not done by the VMS Linker. Instead, the binding is 
established at run time using the DRM routine REGISTER DRM NAMES. 
You call this routine prior to fetching any objects, giving it both the UIL 
name and the procedure address of each callback. The name you register 
with DRM in the application program must match the name you specified 
in the UIL module. 


Each callback procedure receives three arguments. The first two 
arguments have the same form for each callback. The form of the third 
argument varies from object to object. 


The first argument is the address of the data structure maintained by the 
XUI Toolkit for this object instance. This address is called the widget ID 
for this object. — 


The second argument is the address of the value you specified in the 
callbacks list for this procedure. For example, the destroy callback in 
Example 3-5 has app_destroy as its callback procedure. The second 
argument is the address of the integer k_main. If you do not specify an 
argument, the address is null. 


Consult the VMS DECwindows Toolkit Routines oe Manual (which 
describes each object) to find the structure of the third argument. A code 
representing the reason name you specified in the UIL module is the 
first field in this structure. The XUI Toolkit encoding of the UIL reasons 
is contained in the file DECW$DWTDEF.UIL (in the VAX binding) or 
DwtAppl.uil (in the MIT C binding). 


3.5.3 Multiple Procedures per Callback Reason 
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You can specify multiple procedures for each callback reason in UIL by 


_ defining the procedures as a type of list. Just as with other list types, you 


can define procedures lists either inline, or in a separate list section that 
you reference by name. 


If you define a reason more than once (for example, when the reason is 
defined both in a referenced procedures list and in the callbacks list for an 
object), all previous definitions are overridden by the latest definition. 


UIL Module Structure 
3.5 Structure of a List Section 


The following is the syntax for specifying multiple procedures per callback 
reason: 


PROCEDURES procedure_list_spec 


procedure_list_spec ::= 
{ procedure_list_name 
| "{" [procedure_list_clause...] "}" } 


procedure_list_clause ::= 
{ procedure_list_specification | procedure_list_ref } 


_ procedure_list_ref ::] 
procedure_list_name [ "(" [ value_expression ] ")" ] 


callback_list_entry ::= 
reason_name "=" procedure_list_spec 


Example 3-6 shows how to specify multiple procedures per callback reason 
defined inline in an object declaration for the push_button Bees, 


Example 3-6 " Specitying Multiple Procedures per Callback Reason 





object m_quit_button: push_button { 
arguments { 


}3 
callbacks { 

activate = procedures 
{ 
quit_proc ( ‘normal demo exit’ ); /* First proc for activate reason */ 
shutdown (); /* Second proc for activate reason */ 
}; 

}e 

}; 


3.5.4 Controls List Structure 


A controls list defines which objects are children of, or controlled by, a 
particular object. Each controls list entry has the following syntax: 


control_list_entry ::= 
[ MANAGED | UNMANAGED ] object_definition 


If you specify the keyword MANAGED, at run time the object is created 
and managed; if you specify UNMANAGED, the object is created only at 
run time. Objects are managed by default. 


Unlike the arguments list and the callbacks list, a controls list entry that 
is identical to a previous entry does not supersede the previous entry. 

At run time, each controls list entry causes a child to be created when 
the parent is created. If you repeat the same object multiple times in a 
controls list, multiple instances of the child are created at run time. 


See Appendix B for a list of the object types a widget can control. 
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UIL Module Structure 
3.5 Structure of a List Section 


Example 3—7 shows how to declare a controls list. 


Example 3-7 UIL Controls List Declaration 


LIST 
default _main_controls : CONTROLS { 
COMMAND WINDOW main_command; 
MENU_BAR main_menu; 
UNMANAGED LIST BOX file _menu; 
UNMANAGED OPTION MENU edit menu; 





3.6 Structure of an Object Section 
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An object section consists of the keyword OBJECT followed by a sequence 
of object declarations, as follows: 


object_section ::= 
OBJECT object_declaration... 


object_declaration ::= 
object_name ":" 
{ EXPORTED object_definition 
| PRIVATE object_definition 
| object_definition 
| IMPORTED object_type } ";” 


object_definition ::= 
object_type [ procedure_reference ] [WIDGET | GADGET] object_spec 


procedure_reference ::= 
PROCEDURE procedure_name 
[ "(" [ value_expression } ")" ] 


object_spec ::= 
{ object_name 
| "{" list_definition... "}" } 


Use an object declaration to define the objects that are to be stored in the 
UID file. You can reference the object name in declarations that occur 
elsewhere in the UIL module in any context where an object name can be 
used (for example, in a controls list, as a symbolic reference to a widget 
ID, or as the tag_value argument for a callback procedure). Objects can 
be forward referenced; that is, you can declare an object name after you. 
reference it. All references to an object name must be consistent with 
the type of object, as specified in the object declaration. You cannot use a 
name you used in another context as an object name. 


You can specify an object as exported, imported, or private (see 
Section 3.2). 


The object definition contains a sequence of lists that define the 7 
arguments, widget hierarchy, and callbacks for the widget. You can specify 
only one list of each type for an object (see Section 3.5). If you want to —’ 
specify more than one list of arguments, controls, or callbacks, you can do 
so within one list, as follows: 


UIL Module Structure 
3.6 Structure of an Object Section 


object some_widget: 
arguments { 
ARGUMENTS arguments list1; 
ARGUMENTS arguments _list2; 
}; 


In this example, arguments_list1 and arguments_list2 are lists of 
arguments that were previously defined in a LIST section. 


You must include a procedure reference to the widget creation routine 
when declaring a user-defined object. The procedure you specify in the 
procedure reference is the creation routine for the user-defined object. 
(The VMS DECwindows Guide to Application Programming explains how 
to build a user-defined object.) 


See Appendix B for a list of the supported object types. 
Example 3-8 shows how to declare an object. 
Example 3-8 UIL Object Declaration 


OBJECT 
app_main : EXPORTED MAIN WINDOW { 


ARGUMENTS { 
ARGUMENTS default_args; 
HEIGHT = 1000; 
WIDTH = 800; 

de 


CALLBACKS default_callbacks; 


CONTROLS { 
MENU_BAR main_menu; 
USER_DEFINED my_object; 
}; 
}; 





If you want to use gadgets only in certain instances of an object, explicitly 
specify that particular object as a gadget in its declaration, and omit 
that object type from the objects clause on the module header (see 
Section 3.1.4). For example, if you want all push buttons but one to be 
widgets, omit the push button type from the objects clause and declare the 
one exception as a gadget in its object section. 


Since you do not specify the variant for imported objects, the variant (that 
is, whether a widget or gadget) of imported objects is unknown until run 
time. 


The following sections detail UIL syntax for specifying object variants, 
show an example of a UIL module in which gadgets are specified (using 
both the objects clause and explicit declaration methods), and describe UIL 
compiler diagnostics related to gadgets. 
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UIL Module Structure 
3.6 Structure of an Object Section 


3.6.1 Specifying Object Variant in the Module Header 


You can include a default object variant clause in the module header to 
specify the default variant of objects defined in the module, on a type-by- 
type basis. 


The object type can be any user interface object type that has a gadget 
variant (separator, label, push button, or toggle button). If you specify any 
other object type as a gadget, the UIL compiler issues a diagnostic. 


When you include an object type in the objects clause, all objects of that 
type default to the variant you specified in the objects clause. For example, 
the following objects clause specifies that all push buttons in the current 
module are gadgets: 


OBJECTS = { push_button = GADGET; } 


The UIL compiler issues an informational diagnostic if you attempt to 
specify an object type more than once in the objects clause. 


You can override the specification you made in an objects clause when 
you declare a particular object. If you omit the objects clause, or omit an 
object type from the objects clause, the UIL compiler assumes you want 
the omitted type to be widget. You can also explicitly override this default 
in an object declaration. Example 3-9 shows how to use the objects clause 
and how to override the variant specification in an object declaration. 


3.6.2 Specifying Object Variant in the Object Declaration 
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You can use one of the keywords WIDGET or GADGET as an attribute 
of an object declaration. You include the keyword between the object 
type and the left brace of the object specification. Use the GADGET or 
WIDGET keyword to specify the object type or to override the default 
variant for this object type. (The UIL compiler assumes all interface 
objects are widgets by default. You can specify the gadget variant as 
the default for labels, separators, push buttons, and toggle buttons in an 
objects clause on the module header, as described in Section 3.6.1.) 


The object type can be any user interface object type that has a gadget 
variant (separator, label, push button, or toggle button). If you specify any 
other object type as a gadget, the UIL compiler issues a diagnostic. 


Example 3-9 shows how to specify gadgets in UIL. 


UIL Module Structure 
3.6 Structure of an Object Section 


Example 3-9 Specifying User Interface Object Variants 


MODULE sample 
NAMES = case insensitive 
OBJECTS = 
{ separator = GADGET; push_button = WIDGET; } 


OBJECT 
a_button : push_button GADGET { 
ARGUMENTS { label _label = ’choice a’; }; 
}; 
a_menu : pulldown_menu { 
ARGUMENTS { border width = 2; }; 
CONTROLS { . 
push_button a_button; 
separator GADGET {}; 
push_ button { 
ARGUMENTS { label_label = ’choice b’; }; 
}e 
separator WIDGET {}; 
push_button c_button; 
separator {}; 
}3 
}; 
c_button : push_button GADGET { 
ARGUMENTS { label _ label = ’choice c’; }; 
}; 


END MODULE; 


In Example 3-9, the objects clause specifies that all separator objects are 
gadgets and all push button objects are widgets, unless overridden. Object 
a_button is explicitly specified as a gadget. Object a_menu defaults to a 
widget. 


Notice that the reference to a_button in the control list of a_menu refers to 
the a_button gadget; you need to include the gadget attribute only on the 
declaration of a_button, not on each reference to a_button. The same holds 
true for c_button, even though the reference to c_button in the control list 
for a_menu is a forward reference. 


The unnamed push button definition in the control list for a_menu is a 
widget because of the objects clause; the last separator is a gadget for the 
same reason. 


You need to specify the GADGET or WIDGET keyword only in the 
declaration of an object, not when you reference the object. You cannot 
specify the GADGET or WIDGET keyword for a user-defined object; 
user-defined objects are always widgets. 


3.7 Structure of an Identifier Section 


Identifiers provide run-time binding of data to names that you specify in 
a UIL module. Identifiers work like global variables in a programming 
language. 
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UIL Module Structure 
3.7 Structure of an Identifier Section 


List the names of identifiers in an identifier section in a UIL module. An 
identifier section consists of the reserved keyword IDENTIFIER followed 
by a list of names, with each name followed by a semicolon. You can use 
these names later in the UIL module as either the value of an object 
argument or as the tag value to a callback procedure. At run time, use the 
DRM routine REGISTER DRM NAMES to bind the identifer name with 
the data associated with the identifier. (See the VMS DECwindows Toolkit 
Routines Reference Manual for information about the REGISTER DRM 
NAMES routine.) 


Because UIL has a single name space, you cannot use a name you used for 
a value, object, or procedure as an identifier name. 


Your application can successively call the routine REGISTER DRM 
NAMES with the same identifier names to supersede the value of that 
name for all subsequent calls to DRM that might use these identifiers. For 
example, you would use this procedure to change callback tags for objects 
created from a template definition. (Refer to the VMS DECwindows Guide 
to Application Programming for information on using an object definition 
as a template.) 


Example 3-10 shows an identifier section in a UIL module. 


Example 3-10 Using Identifiers in a UIL Module 


MODULE id_ example 


NAMES = CASE INSENSITIVE 
IDENTIFIER 
my _x_id; 
my_y_id; 
my focus_id; 
PROCEDURE 


my _focus_callback ( STRING ); 


OBJECT my_main : MAIN WINDOW { 
ARGUMENTS { 


3 
END MODULE; 


}e 


CALLBACKS 


‘3 


x 
Y 


focus 


my _x_id; 
my_y_id; 


{ 
= PROCEDURE my_focus_callback ( my _focus_id ); 
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The UIL compiler does not do any type checking on the use of identifiers 
in a UIL module. Unlike a UIL value, an identifier does not have a UIL 
type associated with it. You can use an identifier as an object argument or 
callback procedure tag, regardless of the data type specified in the object 
or procedure declaration. 


To reference these identifier names in a UIL module, use the name of the 
identifier wherever you want its value to be used. The value is determined 
at run time. The UIL module in Example 3-10 shows identifiers used as 
argument values and callback procedure tags. However, you can reference 
an identifier in any context where you can reference a value. 


UIL Module Structure 
3.7 Structure of an Identifier Section 


The identifiers my_x_id and my_y_id are used as argument values for the 
main window widget, my_main. The position of the main window widget 
may depend on the screen size of the terminal on which the interface is 
displayed. Using identifiers, you can provide the values of the x and y 
arguments at run time. 


The identifier named my_focus_id is specified as the tag to the callback 
procedure my_focus_callback. In the application program, you could 
allocate a data structure and use my_focus_id to store the address of 
that data structure. When the focus reason occurs, the data structure is 
passed as the tag to procedure my_focus_callback. 


3.8 The UIL Include Directive 


The UIL include directive incorporates the contents of a specified file into 
a UIL module. This mechanism allows several UIL modules to share 
common definitions. The syntax for the include directive is as follows: 


include_directive ::= 
INCLUDE FILE character_expression ";" 


The file specified in the include directive is called an include file. The UIL 
compiler replaces the include directive with the contents of the include 
file and processes it as if these contents had appeared in the current UIL 
source file. 


An include file can contain include directives; therefore, include files can 

be nested. The UIL compiler can process up to 100 references (including 

the file containing the UIL module), allowing you to include up to 99 files 
in a single UIL module (including nested files). Each file opening counts 

as a reference: including the same file twice counts as two references. 


The character expression is a file specification that identifies the file to be 
included. The rules for finding the specified file are similar to the rules 
for finding header, or .h, files using the include directive, #include, with a 
quoted string in the VAX C language. 


If you do not supply a file extension, .UIL is assumed. If you do not supply 
a directory, the UIL compiler searches for the include file in the directory 
of the main source file; if the compiler does not find the include file there, 
the compiler looks in the directory UIL$INCLUDE (if this logical name 
has been defined on your system). If you supply a directory, the UIL 
compiler searches only that directory for the file. 


If you use a search list to specify the directory for the main UIL source 
file, then the compiler uses that search list to locate the included file as 
well; the UIL compiler searches all directories in the list. 


Example 3-11 shows an example of the include directive. 
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UiIL Module Structure © 
3.8 The UIL Include Directive 


Example 3-11 UIL Include Directive 


i+ 
! The .UIL extension is provided by default. 


INCLUDE FILE ’constants’; 





3.9 Definitions for Constraint Arguments 


The XUI Toolkit and the X Toolkit (intrinsics) directly support constraint 
arguments. A constraint argument is one that is passed directly to 
children of an object, beyond those arguments that are normally available. 
For example, the attached dialog box widget is an object that grants a set 
of constraint arguments to its children. These constraint arguments are 
used to control the position of the children in the attached dialog box. 


Because UIL did not directly support constraint arguments in VMS 
Version 5.1, you had to define constraint arguments using the 
ARGUMENT function, as shown in the following example: 


value 
adb_top_attachment: argument ( ‘abdTopAttachment’, integer); 


Unlike the arguments that define the attributes of a particular widget, 
constraint arguments are used exclusively to define the attachments of the 
children of a particular widget. To supply arguments to a child object, you 
include the constraint arguments in the arguments list for the child object, 
as shown in Example 3-12: 


Example 3-12 Defining Constraint Arguments 


object my_dialog box: dialog box { 
arguments { 
x = 70; 
y = 20; 
row = 35; 
}; 
controls { 
push_button { 
arguments { 
adb_left_attachment = DwtATTACH_WIDGET; 
adb_left_offset = 10; 
he 
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Note: 


UIL Module Structure 
3.10 Symbolic References to Widget Identifiers 


Symbolic References to Widget Identifiers 


The UIL compiler allows you to symbolically refer to a widget identifier 
by using its name. This mechanism addresses the problem that the 
UIL compiler views objects by name and the XUI Toolkit views objects 
by widget identifier. Widget identifiers are defined at run time and are 
therefore unavailable for use in a UIL module. . 


When you need to supply an argument that requires a widget identifier, 
you can use the UIL name of that widget and its object type as the 
argument. For example, the menu bar widget has an argument © 
DwtNMenuHelpWidget that expects the identifier of a widget (a pull- 
down menu entry, for instance). You can give the name and object type of 
the pull-down menu entry widget as the value for this argument. Another 
practical use of a symbolic reference is to specify the default push button 
widget (in a dialog box widget or radio box widget). 


To completely specify a symbolic reference in UIL, you must 
include the object type with the object name. 


Example 3-13 shows the use of a symbolic reference. 


Example 3-13 Using Symbolic References in a UIL Module 


MODULE symbolic ref example 
NAMES CASE_INSENSITIVE 


OBJECT my dialog box 
ARGUMENTS { 
default_button 


: DIALOG BOX { 


= PUSH_BUTTON yes_button; 


}3 


CONTROLS { 
PUSH_BUTTON yes_button; 
PUSH BUTTON no_button; 
}; 
}; 
OBJECT yes_button 


ARGUMENTS { 
label label 


: PUSH_BUTTON { 


‘yes’ ; 
}e 

}; 

OBJECT no_button :; 


ARGUMENTS { 
label label 


PUSH BUTTON { 


‘no’; 
}? 
}e 


END MODULE; 


In Example 3-13, two push button widgets are defined, named yes_ 
button and no_button. In the definition of the dialog box widget, the 
name yes_button is given as the value for the default_button argument. 
Usually, the default push button argument accepts a widget identifier. 
When you use a symbolic reference (the object type and name of the yes_ 
button widget) as the value for the default push button argument, DRM 
substitutes the widget identifier of the yes_button push button for its name 
at run time. 
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There is a restriction on the use of symbolic references: the object name 
you reference must be a descendant of the object being fetched in order 
for DRM to find the referenced object; you cannot reference an arbitrary 
object. DRM checks this at run time. . 


The UIL built-in tables listed in Appendix B indicate where symbolic 
referencing of widget identifiers is acceptable by showing the term object 
reference as the type of an argument. 


4.1 


4.1.1 





Using the VIL Compiler 


This chapter describes the following: 

¢ Invoking the compiler 

¢ Using include files 

e¢ Interpreting diagnostics issued by the compiler 


¢ Interpreting the listing produced by the compiler 


Invoking the UIL Compiler 


/LIST Qualifier 


You invoke the UIL compiler with the DCL command UIL. The UIL 
command takes a single parameter, which is the name of the file 
containing the UIL module you want to compile. 


The syntax for the UIL command is as follows: 
UIL [ /qualifier... ] input-file-spec 


If you do not specify a directory, the input file is assumed to be in the 
current default directory. If you omit the file type, the type UIL is 
assumed. 


You can use the qualifiers listed in Table 4—1 on the UIL command line. 


Table 4-1 Command Line Qualifiers for the UIL Compiler 


Command Qualifiers Default 

ANOJLIST[=file-spec] /NOLIST for interactive mode 
/LIST for batch mode 

/[NOJMACHINE_CODE /MACHINE_CODE 

/[NOJOUTPUT[=file-spec] /OUTPUT 

NERSION[=V1 | V2] NVERSION=V2 


/[NO]WARNINGS[=(message_type)] WARNINGS 


The /LIST qualifier directs the compiler to produce a listing file. In 
interactive mode, the default for this qualifier is /NOLIST. In batch mode, 
the default for this qualifier is /LIST. 


When /LIST is in effect, the compiler, by default, creates a listing file in 
the current default directory with the same name as the input file and the 
LIS file type. If you include a file specification with the /LIST qualifier, the 
compiler uses that specification to name the listing file. 
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4.1.2 /MACHINE_CODE Qualifier 


The /MACHINE_CODE qualifier works like the (MACHINE_CODE (or 
equivalent) qualifier available for most high-level language compilers. If 
you specify both /LIS and /(MACHINE_CODE on the UIL command line, 
the compiler places in the listing file a description of the records that it 
wrote to the UID file. This is analogous to a compiler placing the machine 
code it generates for a high-level language in the listing. 


The primary purpose of this listing is to isolate errors in the UIL compiler. 
The default is /NOMACHINE_CODE. 


4.1.3 /OUTPUT Qualifier 


The /OUTPUT qualifier directs the compiler to produce a User Interface 
Definition (UID) file. By default, /OUTPUT creates a UID file in the 
current default directory with the same name as the input file and with 
the UID file type. If you include a file specification with the /OUTPUT 
qualifier, the compiler uses that specification to name the UID file. 


The compiler does not produce a UID file when you use the /NOOUTPUT 
qualifier or when the compiler issues any diagnostics categorized as error 
or severe. You can use the /NOOUTPUT qualifier when you want to verify 
only that your UIL module is syntactically correct. 


4.1.4 /VERSION Qualifier 


The /VERSION qualifier provides upward compatibility between Version 
1.0 and Version 2.0 of the UIL compiler. In particular, the /VERSION 
qualifier allows you to continue building interfaces that will run under the 
XUI Toolkit in VMS Version 5.1 (for example, the processing of newline 
characters that are embedded in compound strings), while still being able 
to use the new UIL compiler features implemented for VMS Version 5.4. 


Allowable values for the /VERSION qualifier are V1 (for VMS Version 5.1) 
and V2 (for VMS Version 5.3 and 5.4). The default is /(VERSION=V2. 


4.1.5 /WARNINGS Qualifier 
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The /WARNINGS qualifier directs the UIL compiler to suppress warning 
or informational messages or both. Table 4—2 describes the supported 
values for the (WARNINGS qualifier. 


Table 4—2 Values for the /WARNINGS Qualifier 


Qualifier 


/WARNINGS 

/WARNINGS=(NOINFORMATIONALS) 
/WARNINGS=(NOWARNINGS) 
IWARNINGS=(NOWARNINGS, NOINFORMATIONALS) 
/NOWARNINGS 


Using the UIL Compiler 
4.1 Invoking the UIL Compiler 


Description 


Generates all diagnostic messages 

Suppresses informational messages 

Suppresses warning messages 

Suppresses warning and informational messages 
Suppresses warning and informational messages 


If the (WARNINGS qualifier is not specified, the UIL compiler generates 


all diagnostic messages. 


4.2 Getting Online Help for the UIL Compiler 


You can access online help for the UIL compiler by entering the following 


command: 


$ HELP UIL 


Online help for the UIL compiler includes the following topics: 


¢ Description of the UIL command parameter and qualifiers 


¢ Description of and corrective action for compile-time errors 


¢ How to use the compiler 


e Summary of the steps needed to integrate a UIL specification with an 


application program 





4.3 Interpreting Compiler Diagnostics 


The UIL compiler issues standard VMS diagnostics to the file 
SYS$ERROR. The following example shows the form of these messages: 


value d: font( 1 ); 
* 


%UIL-E-WRONG TYPE, found integer value when expecting string value 
line: 9 file: DISK$: [PROJECT.UIL.WORK] VALUE_ERROR.UIL;7 


The first line is the source line that produced the diagnostic. If for some — 
reason the compiler cannot retrieve the source line from the input file 
(for example, the file is not a disk file), this line is omitted. Any control 
characters in the text of the line are printed as question marks (7). 


The second line of the diagnostic marks the start of the construct that 
resulted in the diagnostic. In this example, the literal 1 is marked with 
an asterisk. If the error is not associated with a particular construct, the 
second line is omitted. If the source line cannot be retrieved, this line is 
also omitted. The column information is included with the line and file 
information following the diagnostic message. 


The third line is the diagnostic issued by the UIL compiler. 


The fourth line specifies the file containing the source line being diagnosed 
and the line number of the source line within that file. 
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4.3 Interpreting Compiler Diagnostics 


Table 4—3 lists the four levels of diagnostics that the UIL compiler can 
issue, in ascending order of severity. 


Table 4—3 Levels of Diagnostic Messages 





Severity Level Code Compilation Status 

Informational | Accompanies other diagnostics that should be 
investigated. 

Warning WwW Compilation continues. Check that the compiler did 
what you expected. 

Error E Compilation continues. No UID file is generated. 

Fatal (severe) F Compilation terminates immediately. 





4.4 Interpreting the Compiler Listing 
The listing produced by the compiler contains the following information: 
e A title giving miscellaneous information about the compilation 
e Source lines of the input file 
e Source lines of any include files 
e Diagnostics issued by the compiler 
e Summary of the diagnostics issued 


e Summary of the files read 


Example 4—1 shows the contents of a sample listing file. 
Example 4-1 Sample UIL Compiler Listing File 





VMS UIL Compiler V2.0-000 19-APR-1999 15:47:34.31 Page 1 
Module: EXAMPLE Version: X-2 

1 (0) MODULE example VERSION = ’X-2’ 

2 (0) 

3 (0) INCLUDE FILE ’colors.uil’; 

1. ¢1) 

2 (1) VALUE red: COLOR( 91 ); VALUE green: COLOR( 92 ); 

1 2 


SUIL-E-WRONG TYPE (1) found integer value when expecting string value 
SUIL-E-WRONG TYPE (2) found integer value when expecting string value 


3 (1) VALUE blue: COLOR( ‘Blue’ ); 

4 (1) 

4 (0) 

5 (0) OBJECT primary window: 

6 (0) MAIN WINDOW 

7 (0) { ARGUMENTS 

8 (0) { FOREGROUND_COLOR = pink; 


1 
%UIL-E-UNDEFINED (1) value PINK must be defined before this reference 
SUIL-E-OBJ_TYPE (1) found error value when expecting color value 


(continued on next page) 


4.4.1 


4.4.2 
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4.4 Interpreting the Compiler Listing 


Example 4—1 (Cont.) Sample UIL Compiler Listing File 


9 (0) BACKGROUND_COLOR = blue; }}; 
1 
SUIL-E-SYNTAX (1) unexpected RIGHT BRACE token seen - parsing resumes after ";" 
10 (0) }; 
11 (0) END MODULE; 
SUIL-I-SUMMARY (0) errors: 5 warnings: 0 informationals: 0 
file (0) DISK$: [PROJECT.UIL.WORK]A.UIL;1 
file (1) DISKS: [PROJECT.UIL.WORK] COLOR.UIL;2 
Listing Title 


Each new page of the listing starts with a title. The following example 
shows a sample UIL listing title: 


VMS UIL Compiler V2.0-000 19~APR-1999 15:47:34.31 Page 1 
Module: EXAMPLE Version: X-2 


The first line of the title identifies the compiler by name, the version 

of the compiler used for the compilation, and the time the compilation 
started. The version of the compiler, in this case V2.0—000, is important 
information to include with each Software Performance Report (SPR) you 
submit concerning the UIL compiler. The version precisely identifies which 
variant of the compiler you are using. 


The second line of the title lists the module name for the UIL specification 
and the version of that module (if provided in a version clause on the 
module declaration). 


Source Line 


Each source line printed on a UIL compiler listing begins with two 
numbers. These numbers are not part of the source line; the UIL compiler 
includes these numbers for your convenience. The following example of a 
line from a compiler listing shows these numbers: 


1 (0) MODULE example VERSION = ’X-2’ 


The number in parentheses designates from which file the source line was 
read. By looking at the file summary at the end of the listing, you see that 
file (0) is DISK$:[PROJECT.UIL.WORKI]A.UIL;1. The first number on the 
printed line is the number of the source line in the source file. 


If a source line contains any control characters other than tabs, they are 
replaced in the listing by question marks (?). 
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Diagnostics 


Diagnostics for a particular source line follow that line in the listing. 
Example 4—2 shows some sample source lines that contain errors and the 


diagnostics associated with those errors. 


Example 4-2 Diagnostics on a UIL Compiler Listing 


2 (1) VALUE red: COLOR( 91 ); VALUE green: COLOR( 92 ); 

2 2 
SUIL-E-WRONG_ TYPE (1) found integer value when expecting string value 
SUIL-E-WRONG TYPE (2) found integer value when expecting string value 


8 (0) { FOREGROUND_COLOR = pink; 
al 
SUIL-E-UNDEFINED (1) value PINK must be defined before this reference 
SUIL-E-OBJ_TYPE (1) found error value when expecting color value 


The line following the source line points to the position in the source line 
where each of the diagnostics occurred. You can determine the position of 
each diagnostic by looking at the number in parentheses that follows the 
diagnostic abbreviation. For example, diagnostic (1) for source line 2 is at 
position 1 and diagnostic (2) for the same source line is at position 2. The 


diagnostics for source line 8 both occur at position (1 ). 


If a diagnostic has no associated position on the line, the position is given 
as (0). If a diagnostic is not associated with a source line, it appears 
following the last source line. The summary diagnostic, which tallies the 
number of diagnostics of each severity level, is an example of a diagnostic 


with no source line association. 


Summaries 


The UIL compiler listing contains two summaries. Example 4-3 shows the 


summaries on a sample UIL compiler listing. 


Using the UIL Compiler 
4.4 Interpreting the Compiler Listing 


Example 4-3 Summaries on a VIL Compiler Listing 





@ svurL-I-sumMaRY (0) errors: 5 warnings: 0 informationals: 0 


, 2) file (0) DISKS: [PROJECT.UIL.WORK]JA.UIL;1 
file (1) DISK$: [PROJECT.UIL.WORK] COLOR. UIL; 2 


@ The first summary is an informational diagnostic that tallies the 
number of error, warning, and informational diagnostics. 


@ The second summary lists the files that contributed to the UIL 
specification. This list is useful in determining from which file a source 
line in the listing was read. For example, a source line preceded by 
the sequence 532 (3) in the listing was read from line 532 of file (3) 
in the summary list. 
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UIL Diagnostic Messages 


In this appendix, the following strings are used to represent data that 
varies in the actual message you receive from the UIL compiler: 


String Data Represented 





%c -—C Character 
%d Decimal number 
%S String 





Messages are listed alphabetically by IDENT code. 


ARG_COUNT, procedure %s was previously declared with %d arguments 


Severity: Error 


Explanation: The declaration of the marked procedure specified a 
different number of arguments than are present in this procedure 
reference. | 


User Action: Check that you are calling the correct function. If you 
intend to call the procedure with a varying number of arguments, omit the 
argument list in the procedure declaration. . 


ARG_TYPE, found %s value - procedure %s argument must be %s value 


Severity: Error 


Explanation: The declaration of the marked procedure specified a 
different type of argument than is present in this procedure reference. 


User Action: Check that you are passing the correct argument to the 
correct function. If you intend to call the procedure with varying argument 
types, declare the procedure specifying ANY for the type of the argument. 


BACKSLASH_IGNORED, unknown escape sequence "\ %c" - ignored 


Severity: Error 
Explanation: A backslash (\ ) was followed by an unknown escape 


character. The backslash is the escape character in UIL. A selected set of 


single characters can follow a backslash, such as \n for newline or \\ to 
insert a backslash. The character following the backslash was not one of 
the selected set. 


User Action: If you want to add a backslash, use \\. See Chapter 2 for 


a description of the supported escape sequences. 


_ UIL Diagnostic Messages 
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BUG_CHECK, Internal error: %s 


Severity: Severe 
Explanation: The compiler diagnosed an internal error. 
User Action: Submit a Software Performance Report (SPR). 


CIRCULAR_DEF, widget %s is part of a circular definition 


Severity: Error 


Explanation: The indicated object is referenced as a descendant of itself, 
either within its own definition or within the definition of one of the objects 
in the widget hierarchy that it controls. 


User Action: Change the definition of the indicated object so that it is not 
a descendant of itself. | 


CONTROL_CHAR, unprintable character \%d\ ignored 


Severity: Error 


Explanation: The compiler encountered an illegal control character in 


the UIL specification file. The decimal value of the character is given 


between the backslash (\ ) characters. 


User Action: Replace the character with the sequence specified in the 
message (for example, \3\ if the control character’s internal value is 
3). UIL provides several built-in control characters, such as \n and \r 
for newline and carriage return. See Chapter 2 for a complete list of 
supported escape sequences. 


CREATE_PROC, creation procedure is not supported by the %s widget 


Severity: Error 


Explanation: You specified a creation procedure for an XUI Toolkit 
widget. You can specify a creation procedure only for a user-defined 
widget. 


User Action: Remove the procedure clause following the widget type. 


CREATE_PROC_INV, creation procedure is not allowed in a %s widget 


reference 
Severity: Error 


Explanation: You specified a creation procedure when referring to a 
widget. You can specify a creation procedure only when you declare the 
widget. 


User Action: Remove the procedure clause following the widget type. 
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CREATE_PROC_REQ, creation procedure is required in a %s widget 
declaration 


Severity: Error 


Explanation: When defining a user-defined widget, you must specify 
the name of the low-level creation routine for creating an instance of this 
widget. 


User Action: Insert a procedure clause following the widget type in the 
widget declaration. You also need to declare the creation procedure using 
a procedure declaration. For example: 


procedure my list _box_creation_proc(); 


object list_boxl: 
user defined procedure my_list _box_ creation _proc() 
' { arguments ... }; 


CTX _REQ, context requires a %s - %s was specified 
Severity: Error | | 


| Explanation: At the point marked in the specthieution, one me of object 
(such as a widget) is required and your pprciicalion supplies a different 
type of object (such as a value). 


User Action: Check for misspelling or that you have referred to the 
intended object. 


DL VALUE TOO, LARGE, value %s is too large for context buffer 
Severity: Severe 


Explanation: The compiler encountered a table that is too large for DRM 
context buffers. 


- User Action: Break the table into two or more sections. 


DUP_LETTER, color letter used for prior color in this table 
| Severity: Error | | 


Explanation: Each of the letters used to represent a color in a color table 

must be unique. If not, that letter in an icon would represent more than — 

one color; each pixel can have only one color associated with it at a time. — 
_ The letter marked has been assigned to more than one color. 


User Action: Choose which color the letter is to represent and remove or 
assign a new character to any duplicates, © . 


DUP. LIST, %s %s Asad’ specified for this %s %s 
Severity: Error 


_ Explanation: A widget or gadget declaration can have at most one 
- arguments list, one callbacks list, and one controls list. 


User Action: If you want to specify multiple lists of arguments, controls, 
and callbacks, you can do so within one list, For example: 


arguments { arguments list1; arguments: list2; }3 
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GADGET_NOT_SUP, %s gadget is not supported - %s widget will be used 


instead 
Severity: Warning 


Explanation: The indicated object type does not support a gadget variant; 
only a widget variant is supported for this object type. The UIL compiler 
ignores the gadget indication, and creates widgets of this object type. 


User Action: Specify that this object type is a widget instead of a gadget. 


ICON_LETTER, row %d, column %d: letter \"%c"\ not in color table 


Severity: Error 


Explanation: You have specified a color to be used in an icon that is not 
in that icon’s color table. The invalid color is identified in the message by 
displaying the letter used to represent that color between the backslashes 
(\\). This letter was not defined in the specified color table. 


User Action: Either add the color to the icon’s color table or use a 
character representing a color in the color table. The default color table 
defines " " as background and "*" as foreground. 


ICON_WIDTH, row %d must have same width as row 1 


Severity: Error 


Explanation: The icons supported by UIL are rectangular (that is, x 
pixels wide by y pixels high). As a result, each of the strings used to 
represent a row of pixels in an icon must have the same length. The 
specified row does not have the same length as the first row. 


User Action: Make all the strings in the icon function the same length. 


INV_MODULE, invalid module structure - check UIL module syntax 


Severity: Error . 
Explanation: The structure of the UIL module is incorrect. 


User Action: If there are any syntax errors reported, fix them and 
recompile. For example, if the error occurs before the first object 
declaration (that is, before your value and object declarations), check 
the syntax of the module header for unwanted semicolons (;) after the 
module clauses. If the error occurs at the end of the module, check that 
the module concludes with the clause "end module;”". 


LIST_ITEM, %s item not allowed in %s %s 


Severity: Error 


Explanation: The indicated list item is not of the type required by the 
list. Arguments lists must contain argument entries, callbacks lists must 
contain callback entries, and controls lists must contain control entries. 


- User Action: Check the syntax for the type of list entry that is required 


in this context and change the indicated list item. 
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LISTING_OPEN, error opening listing file: %s 
Severity: Severe 


Explanation: The compiler could not create the listing file noted in the 
message. 


User Action: Check that you have write access to the directory you 
specified to hold the listing file. 

LISTING_WRITE, error writing to listing file: %s 
Severity: Severe 


Explanation: The compiler could not write a line into the listing file 
noted in the message. 


User Action: Check to see that there is adequate space on the disk 
specified to hold the listing file. 

NAME_TOO_LONG, name exceeds 31 characters - truncated to: %s 
Severity: Error | 


Explanation: The UIL compiler encountered a name longer than 31 
characters. The compiler truncated the name to the leftmost 31 characters. 


User Action: Shorten the name in the UIL module source. 


NAMES, place names clause before other module clauses 
Severity: Error 


Explanation: The case-sensitivity clause, if specified, must be the first 
clause following the module’s name. You have inserted another module 
clause before this clause. 


User Action: Reorder the module clauses so that the case-sensitivity 
clause is first. (It is acceptable to place the version clause ahead of the 
case-sensitivity clause; this is the only exception.) 

NEVER_DEF, %s %s was never defined 
Severity: Error 


Explanation: Certain UIL objects such as gadgets and widgets can be 
referred to before they are defined. The marked object is such an object, 
however, the compiler never found the object’s declaration. 


User Action: Check for misspelling. If the module is case sensitive, the 
spellings of names in declarations and in references must match exactly. 


NO_UID, no UID file was produced 
Severity: Informational 


Explanation: If the compiler reported error or severe diagnostics (that is, 
any of the diagnostic abbreviations starting with %UIL-E or %UIL-F), a 
UID file is not created. This diagnostic informs you that the compiler did 
not produce a UID file. 


User Action: Fix the problems reported by the compiler. 
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NON_PVT, value used in this context must be private 


Severity: Error 


Explanation: A private value is one that is not imported or exported. In 
the context marked by the message, only a private value is legal. This 
message may be issued when you have defined one value in terms of 
another, or when you have defined arguments of functions. In general, 

a value must be private when the compiler must know the value at . 
compilation time. Exported values are disallowed in these contexts, even 
though a value is present, because those values could be overridden at run 
time. 


‘User Action: Change the value to be private. 


NOT_IMPL, %s is not implemented yet 


Severity: Error 


Explanation: You are using a feature of UIL that has not been 
implemented. 


User Action: Try an alternate technique. 


-NULL, a NULL character in a string is not supported 


Severity: Warning 


Explanation: You have created a string that has an embedded null | 
character. Strings are represented in a UID file and in many XUI Toolkit 
data structures as null-terminated strings. So, although the embedded 
nulls will be placed in the UID file, XUI Toolkit routines may interpret an 
embedded null as the terminator for the string. 


User Action: Use embedded nulls very carefully. 


OBJ_TYPE, found %s %s when expecting %s %s 


Severity: Error 


Explanation: Most arguments take values of a specific type.. the value 
specified is not correct for this argument. 


User Action: The message indicates the expected type of een 
Check that you have specified the intended value and that you epociee 
the correct argument. 


OPERAND_TYPE, %s type is not valid for %s 


Severity: Error 


Explanation: The indicated operand is not of a type that is supported by — 
this operator. 


User Action: Check the definition of the operator and make sure the type 
of the operand you specify is supported by the operator. 
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OUT_OF_MEMORY, compiler ran out of virtual memory 
Severity: Severe 
Explanation: The compiler ran out of virtual memory. 


User Action: Reduce the size of your application. 


OUT_RANGE, value of %s is out of range %s 
Severity: Error 
Explanation: The value specified is outside the legal range of its type. 


User Action: Change the UIL module source. 


PREV_ERROR, compilation terminated - fix previous errors 
Severity: Severe 


Explanation: Errors encountered during the compilation have caused the 
compiler to abort. 


User Action: Fix the errors already diagnosed by the compiler and 
recompile. 


PREVIOUS_DEF, name %s previously defined as %s 
Severity: Error 


Explanation: The name marked by the message was used in a previous 
declaration. UIL requires that the names of all objects declared within a 
module be unique. 


User Action: Check for a misspelling. If the module is case sensitive, the 

case of names in declarations and in references must match exactly. 
SINGLE_LETTER, color letter string must be a single character 

Severity: Error 


Explanation: The string associated with each color in a color table must 
hold exactly one character. You have specified a string with either fewer or 
more characters. 


User Action: Use a single character to represent each color in a color 
table. 


SINGLE_OCCUR, %s %s supports only a single %s %s 
Severity: Warning 


Explanation: You have specified a particular clause more than once in a 
context where that clause can occur only once. For example, the version 
clause in the module can occur only once. 


User Action: Choose the correct clause and delete the others. 
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SRC_LIMIT, too many source files open: %s 


Severity: Severe 


Explanation: The compiler has a fixed limit for the number of source and. 
include files that it can process. This number is reported in the message. 


User Action: Use fewer include files. 


SRC_NULL_CHAR, source line contains a null character 


Severity: Error 


Explanation: The specified source line contains a null character. The 
compiler ignores any text following the null character. 


User Action: Replace each null character with the escape sequence \0\. 


SRC_OPEN, error opening source file: %s 


Severity: Severe 


Explanation: The compiler could not open the UIL specification file listed 
in the message. 


User Action: Check that the file listed in the message is the one you 
want to compile, that it exists, and that you have read access to the file. If 
you are using a large number of include files, you may have exceeded your 
quota for open files. 


SRC_READ, error reading next line of source file: %s 


Severity: Severe 


Explanation: The compiler could not read a line of the UIL specification 
file listed in the message. 


User Action: In the listing file, this message should appear following the 
last line the compiler read successfully. First check that the file you are 
compiling is a UIL specification file. If it is, the file mostly likely contains 
corrupted records. 


SRC_TRUNCATE, line truncated at %d characters 


Severity: Error 


Explanation: The compiler encountered a source line greater than 132 
characters. Characters beyond the 132-character limit were ignored. 


User Action: Break each source line longer than 132 characters into 
several source lines. Long string literals can be created using the 
concatenation operator. 


SUBMIT_SPR, internal error - submit an SPR 


Severity: Severe 
Explanation: The compiler diagnosed an internal error. 


User Action: Get a listing and look where the error is being issued. Try 
fixing any faulty syntax in this area. If you are unable to prevent this 
error, submit a Software Performance Report (SPR). 
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SUBNOTALL, Subqualifier not allowed with negated qualifier 
Severity: Severe 


Explanation: Subqualifiers are not allowed for the negative form 
of this qualifier. For example, /NOWARNINGS is correct but 
/NOWARNINGS=NOINFORMATIONALS is not allowed. 


User Action: Use the positive form of the qualifier. For example, 
/WARNINGS=NOINFORMATIONALS. 

SUMMARY, errors: %d warnings: %d informationals: %d 
Severity: Informational 


Explanation: This message lists a summary of the diagnostics issued by 
the compiler, and appears only when diagnostics have been issued. 


User Action: Fix the problems reported. You can use the /WARNINGS 
qualifier to suppress informational and warning diagnostics that you have 
determined to be harmless. 

SUPERSEDE, this %s %s supersedes a previous definition in this %s %s 
Severity: Informational 


Explanation: An arguments or callbacks list has either a duplicate 
argument or a duplicate reason. 


User Action: This is not necessarily an error. The compiler is alerting 
you to make sure that you intended to override an prior argument’s value. 
This informational message can be suppressed using the /WARNINGS 
qualifier. 


SYNTAX, unexpected %s token seen - parsing resumes after \"%c"\ 
Severity: Error 


Explanation: At the point marked in the module, the compiler found 
a construct such as a punctuation mark, name, or keyword when it was 
expecting a different construct. The compiler continued analyzing the 
module at the next occurrence of the construct stated in the message. 


User Action: Check the syntax of your UIL module at the point marked 
by the compiler. If the module specifies case-sensitive names, check that 
your keywords are in lowercase characters. 

TOO_MANY, too many %ss in %s, limit is %d 
Severity: Error 


Explanation: You exceeded a compiler limit, such as the number of 
fonts in a font table or the number of strings in a translation table. The 
message indicates the limit imposed by the compiler. 


User Action: Restructure your UIL module. 
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UID_OPEN, error opening UID file: %s 


Severity: Severe 


Explanation: The compiler could not create the UID file noted in the 
message. A UID file holds the compiled user interface specification. 


User Action: Check that you have write access to the directory you 
specified to hold the UID file. If you have a large number of source and 
include files, check that you have not exceeded your open file quota. 


UNDEFINED, %s %s must be defined before this reference 


Severity: Error 


Explanation: The object pointed to in the message was either never 
defined or not defined prior to this point in the module. The compiler 
requires the object to be defined before you refer to the object. 


User Action: Check for a misspelling of the object’s name, a missing 
declaration for the object, or a declaration of the object after its first 
reference. If names in the module are case sensitive, the case of the name 
in the declaration and in the reference must match exactly. 


UNKNOWN_CHARSET, unknown character set 


Severity: Error 


Explanation: The message is pointing to a context where a character set 
name is required. You have not specified the name of a character set in 
that context. 


User Action: Check for misspelling. A list of the supported character sets 
is given in Chapter 2. If you specified case-sensitive names in the module, 
check that the character set name is in lowercase characters. 


UNKNOWN_SEQ, unknown sequence \"%s"\ ignored 


Severity: Error 


Explanation: The compiler detected a sequence of printable characters 
it did not understand. The compiler omitted the sequence of characters 
listed between the quotation marks (" "). 


User Action: Fix the UIL module source. 


UNSUPPORTED, the %s %s is not supported for the %s %s 


Severity: Warning 


Explanation: Each widget or gadget supports a specific set of arguments, 
reasons, and children. The particular argument, reason, or child you 
specified is not supported for this widget or gadget. 


User Action: See the UIL built-in tables in Appendix B for the 
arguments, reasons, and children supported for each object. If a low- 
level creation routine accepts an argument that UIL rejects, this does not 
necessarily indicate that the UIL compiler is in error. Low-level routines 
ignore arguments that they do not support, without notifying you that the 
argument is being ignored. 
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UNTERM_SEQ, %s not terminated %s 
Severity: Error 


Explanation: The compiler detected a sequence that was not properly 
terminated, such as a string literal without the closing quotation mark. 


User Action: Insert the proper termination characters. 
WRONG_TYPE, found %s value when expecting %s value 


Severity: Error 


Explanation: The indicated value is not of the specific type required by 
UIL in this context. 


User Action: Check the definition of the function or clause. 
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UIL Built-In Tables 


This appendix contains a listing of the UIL built-in tables used during 
compilation to check that your UIL specification is consistent with the XUI 
Toolkit. 


For each object in the XUI Toolkit, this appendix contains a table that 
lists the reasons, controls (children), and arguments (widget attributes) 
supported by UIL for the object. In addition, the data type and default 
value of each supported argument are listed. The tables are arranged 

alphabetically by object name. 


UIL has its own generic data types for arguments. These generic data 
types map to VAX or MIT C binding data types. UIL forces you to specify 
argument values of the correct data type, and is more structured than 
the Toolkit in this regard. When you use UIL to specify an interface, you 
must use UIL data types as indicated in the UIL built-in tables in this 
appendix. 


The default values have been included in this appendix to give an 
indication of the behavior of the object when you do not specify particular 
arguments in the UIL module. For example, if you do not specify the 
border width for an object, the object is displayed with a border that is 

1 pixel wide. These defaults implement the appearance of objects 
described in the XUI Style Guide. 


For a complete description of the arguments, refer to the low-level creation 
routine for the object in the VMS DECwindows Toolkit Routines Reference 
Manual. The common arguments, or common attributes, supported by all 
objects are described in the introduction to Chapter 8, which contains the 
low-level creation routine descriptions. Chapter 8 also explains the widget 
class hierarchy and attribute inheritance, which you need to understand 
in order to locate the description of arguments (attributes) that the object 
inherits from its superclasses. 


In general, the UIL name for an argument closely resembles the XUI 
Toolkit name for that argument. (Arguments are called widget-specific 
attributes in the VMS DECwindows Toolkit Routines Reference Manual. 
Callback attributes in the XUI Toolkit are represented by reasons in UIL.) 
In those cases where the XUI Toolkit attribute name is a UIL keyword, the 
UIL name for the argument has been configured to avoid ambiguity; the 
argument name is appended to the object name (or an abbreviated form of 
the object name). 


For example, some objects have a label argument. Because label is also 
a type of object, the UIL name for this argument is label_label. To take 
another example, the command window widget has a value argument. 
Because VALUE is a UIL keyword, the UIL name for this argument is 
command_value. 


UIL Built-In Tables 
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Some arguments take a symbolic reference to a widget identifier as their 

value. These arguments are denoted by the term object reference in the 
Type column for the argument. To specify a symbolic reference to a widget *- 
identifier, supply the type and name of an object that i is defined in your 


UIL module. For example: 


arguments { 


default_button = push_button my_push_button; 


he 


Table B—1 lists the UIL object type for each widget class in the XUI 
Toolkit. DRM uses the object type to determine the low-level creation 


routine call to construct.. Use the generic name to locate the corresponding - _ 


high- and low-level widget creation routines in the VMS DECwindows 
Toolkit Routines Reference Manual. 


Table B—1 UIL Object Types 





Generic Name 


Attached dialog box 
Caution box 

Color mix 
Command window 
Compound string text 
Dialog box 

File selection 

Help box 

Label widget 

Label gadget 

List box 

Main window 

Menu bar 

Message box 
Option menu 


Popup attached dialog box . 
~ Popup dialog box 


Popup menu 

Pulldown menu entry widget 
Pulldown menu entry gadget 
Pulldown menu 

Push button widget 

Push button gadget 


UIL Name 


attached_dialog_| box 
caution_box | 
color_mix 
command_window 
compound_str_txt. 
dialog_box 
file_selection 
help__box 
label_label 
label_label 

listbox — 
main_window 
menu_bar 
message_box 
option_menu 
popup_attached_db 


- popup_dialog_box — 


popup_menu 

pulldown_entry 
pulldown_entry 
pulldown_menu 


push_button 


push_button 





(continued on next page) . 
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Table B-1 (Cont.) UIL Object Types 


Generic Name 


Radio box 

Scale 

Scroll bar 

Scroll window 
Selection 

Separator widget 
Separator gadget 
Simple text 

Toggle button widget 
Toggle button gadget 
User defined 
Window 

Work area menu 

~ Work-in-progress box 


UIL Name 


radio_box 

scale 

scroll_bar 
scroll_window 
selection 
separator 
separator 
simple_text 
toggle_button 
toggle_button 
user_defined 
window 
work_area_menu 
work_in_progress_box 
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B.1 


UIL Built-In Tables 


B.1 Attached Dialog Box 





Attached Dialog Box 


Table B—2 shows the controls, reasons, and arguments supported by the 
attached dialog box widget. 


Table B-2 Attached Dialog Box 











Controls Reasons Arguments 
Name UIL Data Type Default Value 

attached_dialog_ box create accelerators translation__ Null 

table 
caution_box destroy adb_bottom_ integer DwtAttachNone 

attachment . 
color_mix focus adb_bottom_offset integer 0 
command_window help adb_bottom_position integer 0 
compound_str_txt map adb_bottom_widget object Null 
; reference 
dialog_box unmap adb_left_attachment integer DwtAttachNone 
file_selection adb_left_offset integer 0 
help_box adb_left_position integer 0 
label’ adb_left_widget object Null 
reference 

list_box adb_right_attachment integer DwtAttachNone 
main_window adb_right_offset integer 0 
menu_bar adb_right_position integer 0 
message_box -adb_right_widget object Null 

reference . 
option_menu adb_top_attachment integer DwtAttachNone 
popup_attached_db adb_top_offset integer 0 
popup_dialog_box adb_top_position - integer 0 
-popup_menu adb_top_widget object Null 

reference 

pulldown_entry' background_color color Default background color 
pulldown_menu background_pixmap pixmap Null 
push_button' border_color color Default foreground color 
radio_box border_pixmap pixmap Null 
scale border_width integer 1 pixel 
scroll_bar cancel_button object ~ Null 

reference 
scroll_window default_button object Null 

reference 





‘Widget and gadget variants are supported. 
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‘Table B-2 (Cont.) Attached Dialog Box 


Controls 


selection 


separator’ 
simple_text 
toggle_button' 
user_defined 
window 
work_area_menu 


work_in_progress_box 


Reasons 


Name 


default_horizontal_ 


- offset 


default_position 
default_vertical_offset 
direction_r_to_| 
font_argument 
fraction_base 


grab_merge_ 
translations 


height 


mapped_when_ 
managed 


margin_height 
margin_width 
resizable 

resize 
resize_mode — 
rubber_positioning 
sensitive 


text_merge_ 
translations 


translations 


units 
user_data 
width 


UIL Built-In Tables 
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Arguments 


UIL Data Type 


integer 


boolean 
integer 
boolean 
font_table 
integer 


translation 
table 


integer 


boolean 


integer 
integer 
boolean 
integer 
integer 
boolean 
boolean 


translation 
table 


translation 
table 


integer 
any 
integer 


integer 


integer 


Default Value 


0 pixels 


False 

0 pixels 

False 

Default system font 
100 


Default translation table 
syntax 


5 pixels or as large as 
needed to hold children 


True 


1 pixel 

1 pixel 

True 
DwtResizeGrowOnly 
DwtResizeGrowOnly 
False 

True 

Null 


Default translation syntax 


DwtFontUnits 
Null 


5 pixels or as large as 
needed to hold children 


Determined by geometry 
manager 


Determined by geometry 
manager 





'Widget and gadget variants are supported. 
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B.2 


VIL Built-In Tables 


' B.2 Caution Box 





Caution Box 


~ Table B-3 shows the controls, reasons, and arguments supported by the 


caution box widget. 


Table B-3 Caution Box 











Controls Reasons aiouments 
. Name UIL Data Type Default Value 
No children: are cancel accelerators translation_ Null 
supported table 
create auto_unmanage boolean True 
destroy auto_unrealize boolean False 
focus background_color color Default background color 
help background_pixmap pixmap Null 
map border_color color Default foreground color 
no border_pixmap pixmap Null 
unmap border_width | integer 1 pixel 
yes cancel_label compound_ Null 
string 
default_position boolean False 
default_pushbutton integer DwtYesButton 
_ direction_r_to_| _ boolean False 
font_argument font_table Default system font 
height integer 5 pixels or as large as 
needed to hold children 
icon_pixmap pixmap Null 
label_alignment integer DwtAlignmentCenter 
label_label compound_ Object name 
string 
mapped_when_ boolean True 
managed 
margin_height integer 10 pixels 
margin_width integer 12 pixels 
no_label compound_ "No” (DwtSNo) 
string 
no_resize boolean No (no window manager 
resize button) 
resize integer DwtResizeShrinkWrap 
resize_mode integer DwtResizeShrinkWrap 
second_label compound_ Null 
string 


i 


(continued on next page) 


UIL Built-In Tables 
B.2 Caution Box 


Table B--3 (Cont.) Caution Box 








Controls Reasons , nroumente 
Name : | | UIL Data Type Default Value 
second_label__ ' integer DwtAlignmentBeginning 
alignment . 
sensitive boolean True 
style integer DwtModal 
take_ focus boolean True (modal); False 
(modeless) — 
title compound__- Object name 
string 
translations translation_ Default translation table 
— table syntax 

user_data any Null 
width integer 5 pixels or as large as 

needed to hold children 
X _integer Determined by geometry 

manager 
y integer Determined by geometry 
Manager 
~ yes_label compound... "Yes" (DwtSYes) 
string | 
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B.3 


UIL Built-In Tables 
B.3 Color Mix 


Color Mix 


Table B—4 shows the controls, reasons, and arguments supported by the 
color mix widget. 


Table B—4 Color Mix 





Controls Reasons Aroumerts 
Name UIL Data Type Default Value 
No children are apply accelerators translation Null 
supported table 
cancel apply_label compound_ "Apply" 
string 
create auto_unmanage boolean True 
destroy auto_unrealize boolean False 
focus back_blue_value color 
help back_green_value color 
map back_red_value color 
ok background_color color Default background color 
unmap background_pixmap pixmap Nuil 
black_label compound_ "Black" 
string 
blue_label . compound_ "Blue" 
string 
border_color color Default foreground color 
border _pixmap pixmap Null 
border_width integer 1 pixel 
cancel_button object Null 
reference 
cancel_label compound_ "Cancel" 
string 
child_overlap boolean True 
color_model integer DwtColorModelHLS 
default_button object Null 
reference 
default_position boolean False 
direction_r_to_| boolean False 
disp_win_margin integer 20 
display_col_win_height — integer 80 
display_col_win_width integer 80 
display_label compound_ Null 
string 


(continued on next page) 


UIL Built-In Tables 
B.3 Color Mix 


Table B-4 (Cont.) Color Mix 








Controls Reasons Arguments 
Name UIL Data Type Default Value 
display_window object Null 
reference 
font_argument font_table Default system font 
full_label compound_ "Full" 
. string 
grab_merge_ translation_ Default translation table 
translations table syntax 
gray_label compound_ "Gray" 
string 
green_label compound_ "Green" 
string 
height integer 5 pixels or as large as 
needed to hold children 
his_label compound_ "HLS" 
string 
hue_label compound_ “Hue:” 
string 
light_label compound_ “Lightness:" 
string 
main_label compound_ Null 
string 
mapped_when_ boolean True 
managed . 
margin_height integer 3 pixels 
margin_width integer 3 pixels 
match_colors boolean 
mixer_label compound_ Null 
string 
mixer_window object Null 
| reference 
new_blue_value color 
new_disp_window object Null 
reference 
new_green_value color 
new_red_value color 
ok_label compound_ "Ok" 
string 
option_label compound __ "Color Model: " 
String 





(continued on next page) 
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UIL Built-In Tables 
B.3 Color Mix 


Table B—4 (Cont.) Color Mix 








Controls Reasons , . 7 nen? a2 
Name UIL Data Type Default Value 
orig_blue_vaiue color | 
orig_disp_window object Null 

; reference 
orig_green_value color 
orig_red_value color 
red_label compound_ "Red" 
string 
reset_label compound_ "Reset" 
string 
resize . integer DwtResizeGrowOnly 
resize_mode integer DwtResizeGrowOnly 
rgb_label compound_ "RGB" 
. string 
sat_label compound_ "Saturation:” 
string 
sensitive boolean True 
set_new_color_proc any 
slider_label compound_ "Percentage" 
string 
style integer DwtModeless 
text_merge_ transiation_ Null 
translations table 
title compound__ Color Mixing 
string 
translations translation_ Default translation table 
table syntax 
units integer DwtFontUnits 
user_data any Null . | 
value_label compound__ "Value" 
string 
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UIL Built-In Tables 
B.3 Color Mix 


Table B—4 (Cont.) Color Mix 








Controls Reasons erguments 

Name UIL Data Type Default Value 

white_label compound_ "White" 

‘; string 

width integer 5 pixels or as large as 
needed to hold children 

work_window object Null 

reference 

x integer Determined by geometry 
manager 

y integer Determined by geometry 
manager 
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UIL Built-In Tables 
B.4 Command Window 





Command Window 


Table B—5 shows the controls, reasons, and arguments supported by the 
command window widget. 


Table B—-5 Command Window 
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_ Controls Reasons prgaments 
Name UIL Data Type Default Value 
No children are command_ _ accelerators translation_ Null 
supported entered | table 
create background_color color Default background color 
destroy background_pixmap pixmap Null 
focus border_color color Default foreground color 
help border_pixmap pixmap Null 
map border_width integer 1 pixel 
unmap command_value string Null 
value_ default_position boolean True 
changed 
direction_r_to_| boolean False 
font_argument font_table Default system font 
height integer 51 pixels or as large as 
needed to show history 
lines and command line 
history string "" (Null string) 
lines integer 2 lines 
mapped_when_ boolean True 
managed 
margin_height integer 1 pixel 
margin_width integer 1 pixel 
prompt compound_ ">" 
string 
sensitive boolean True 
text_translation translation Null 
table 
translations translation_ Default translation table 
table syntax 
user_data any Null 
width integer 33 pixels 
x integer Determined by geometry 
manager 
y integer Determined by geometry 


manager 
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| _ UIL Built-In Tables 
B.5 Compound String Text Widget 


Compound String Text Widget 


Table B—6 shows the controls, reasons, and arguments supported by the 
compound string text widget widget. 


Table B-6 Compound String Text Widget 








Controls Reasons erouments : 
Name UIL Data Type Default Value 
No children are activate auto_show_insertion__ boolean True 
supported point 
create background_color color Default background color 
destroy background_pixmap pixmap Null 
focus bidirectional_cursor boolean : False 
help blink_rate integer ~ §00 milliseconds 
lost_focus border_color color: Default foreground color 
no_font border_pixmap pixmap Null 
value_ border_width integer 1 pixel 
changed 
cols — integer 1 
compound_text_value compound_ Null 
string 
direction_r_to_| boolean False 
editable boolean _ True 
font_argument font_table Default system font 
foreground_color color Default foreground color 
half_border boolean True 
height integer (rows * font height) + (2 * 
margin height) 
insertion_point_visible boolean True 
insertion_position integer 0 
mapped_when_ boolean True 
managed 
margin_height integer "2 pixels 
margin_width integer 2 pixels 
max_length integer MAXINT; the largest . 
number that can fit in 
a C long ((2°*31)-1, or 
2,147,483,647) 
pending_delete boolean True 
resize_height boolean True 
resize_width boolean . True 





(continued on next page) 
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VIL Built-In Tables 
B.5 Compound String Text Widget 


Table B-6 (Cont.) Compound String Text Widget 





Controls Reasons Arguments 

Name - UIL Data Type Default Value 

rows integer 20 

scroll_horizontal — boolean False 

scroll_left_side ~~ boolean False 

scroll_top_side boolean False 

scroll_vertical boolean False 

sensitive boolean True 

top_position integer 0 

transiations translation_ Default translation table 

table syntax 

widget_direction integer False 

width . integer (columns * average 
character width) + (2 * 
margin width) 

word_wrap boolean False 

x integer Determined by geometry 
manager 

y. integer Determined by geometry 
manager 
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B.6 














UIL Built-In Tables 


B.6 Dialog Box 


Dialog Box 
Table B—7 shows the controls, reasons, and arguments supported by the 
dialog box widget. 
Table B-7 Dialog Box 
Controls Reasons Arouments 
Name UIL Data Type Default Value 
attached_dialog_box create accelerators translation_ Null 
. table 
caution_box destroy background_color color Default background color 
color_mix focus background_pixmap pixmap Null 
command_window help border_color color Default foreground color 
compound_str_txt map border_pixmap pixmap Null . 
dialog_box unmap border_width integer 1 pixel 
file_selection cancel_button object Null 
reference 
help_box child_overlap boolean True 
label! default_button object Null 
reference 
list_box default_position boolean False 
main_window direction_r_to_| boolean _ False 
menu_bar font_argument font_table Default system font 
message_box grab_merge_ translation_ Default translation table 
translations table syntax 
option_menu height integer 5 pixels or as large as 
; needed to hold children 
popup_attached_db mapped_when_ boolean True 
managed 
popup_dialog_box margin_height integer 3 pixels (popups); 1 pixel 
(all others) 
popup_menu margin_width integer 3 pixels (popups); 1 pixel 
(all others) 
pulldown_entry' resize integer DwtResizeGrowOnly 
pulldown_menu resize_mode integer DwtResizeGrowOnly 
push_button' sensitive boolean - True 
radio_box text_merge_ translation Null 
translations table 
scale translations translation_ Default translation table 
table syntax 
scroll_bar units integer DwtFontUnits 





‘Widget and gadget variants are supported. 
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UIL Built-In Tables 
B.6 Dialog Box 


Table B—7 (Cont.) Dialog Box 








Controls Reasons eaumens 
Name UIL Data Type Default Value 
scroll_window user_data any Null 
selection _ width integer 5 pixels or as large as 
. needed to hold children 
separator’ 4 integer Determined by geometry 
; manager 
simple_text y integer -~—dDetermined by geometry 
manager 


toggle_button' 
user_defined 

window 

work _area_menu 
work_in_progress_box 





'Widget and gadget variants are supported. 





B-16 


B.7 


UIL Built-In Tables 
B.7 File Selection 


File Selection 


Table B—-8 shows the controls, reasons, and arguments supported by the 
.. file selection widget. 


Table B-8 File Selection 








- Controls Reasons Arguments 
Name UIL Data Type Default Value 
attached_dialog_box activate accelerators translation_ Null 
table 

caution_box cancel apply_label compound __ "Apply" 

string 
color_mix create auto_unmanage boolean True 
command_window destroy auto_unrealize boolean False 
compound_str_txt focus background_color color Default background color 
dialog_box help background_pixmap pixmap Null 

~ file_selection . map border_color color Default foreground color 

help_box no_match border_pixmap pixmap Null 
label’ unmap border_width integer 1 pixel 
list_box cancel_label compound_ "Cancel" 

string 
main_window default_position boolean False 
menu_bar dir_mask compound_ ce 

string 
message_box direction_r_to_| boolean False 
option_menu file_search_proc any FileSelectionSearch 
popup_attached_db file_selection_value compound_ Null 

string 
popup_dialog_box file_to_extern_proc any Null 
popup_menu file_to_intern_proc any Null 
pulldown_entry' filter_label compound_ "File filter” 

String 
pulldown_menu font_argument font_table Default system font 
push_button' height integer 5 pixels or as large as 

needed to hold children 

radio_box items string_table Null 
scale label_label compound_ "Files in” 

string 
scroll_bar list_updated boolean False 
scroll_window mapped_when_ boolean True 

managed 





‘Gadget variant is not supported. 
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UIL Built-In Tables 
B.7 File Selection 


Table B-8 (Cont.) File Selection 





Arguments 








Controls 
Name UIL Data Type Default Value 
selection margin_height integer 2 pixels 
separator’ margin_width integer 2 pixels 
simple_text _ Mask_to_extern_proc = any Null 
toggle_button' mask_to_intern_proc any Null 
user_defined — Must_match . boolean False 
window no_resize boolean True 
work_area_menu ok_label compound_ = "Ok" 
. string 
work_in_progress_box resize integer Grow only 
(DwtResizeGrowOnly) 
resize_mode integer Grow only 
. (DwtResizeGrowOnly) 
selection_label compound_ "Selection" 
; . string © 
sensitive boolean True 
style integer Modal (DwtModal) 
take_focus boolean True (modal); False 
(modeless) 
text_cals integer 30 
title compound_ “Open” 
string 
translations translation_ Default translation table 
table syntax 
user_data any Null 
visible_items_count integer | 8 
width integer 5 pixels or as large as 
needed to hold children 
integer Centered in parent 
integer Centered in parent 





‘Gadget variant is not supported. 
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.. -UIL Built-In Tables 
-B.8 Help Box 














Help Box | ao 
| Table B-9 shows the controls, reasons, and arguments supported by the 
help box widget: cna’ , 
Table B-9 Help Box 
Controls | Reasons — Arguments 
Name UIL Data Type Default Value 
No children are create about_label compound_ “About” - 
supported . string | 
destroy add_topic_label compound__ "Additional topics:" 
| . string . 
“help application_name compound_ Null 
_~ string . : 
map background_color color Default background color 
unmap background_pixmap pixmap Null 
bad_frame_message compound_ "Couldn't find frame %s in 
string %s library\n" 
bad_library_ message compound_ "Couldn't open library %s 
string \n" 
border_color color Default foreground color 
border_pixmap pixmap Null 
cache_help_library boolean True 
close_label compound_ "Close" 
string 
cols. integer 55 
copy_label compound_ "Copy" 
string 
default_position boolean True 
direction_r_to_| boolean False 
dismiss_label compound_ "Dismiss" 
string 
edit_label . compound_ "Edit" 
ae String ; 
error_open_message compound_ _._ “Error opening file %s\n" 
: . . String 
exit_label compound_ "Exit* 
string 
file_label compound_ "File" 
string 
first_topic compound_ Null 
string 
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UIL Built-In Tables 
B.8 Help Box 


Table B-9 (Cont.) Help Box 











Controls Reasons Arguments 
Name UIL Data Type Default Value 
font_argument font_table Default system font 
foreground_color color Default foreground color 
glossary_label compound_ "Glossary" 
string 
glossary_topic compound_ Null 
string 
go_back_label compound_ "Go back" 
string 
go_over_label compound_ "Go to Overview" 
string 
go_to_label compound_ "Go To" 
string 
gobacktopic_label compound_ "Go back topic" 
string 
gototopic_label compound_ "Go to topic” 
string 
help_acknowledge_ compound_ "Acknowledge" 
label string 
help_font font_table Default Help font" 
help_label compound_ "Help" 
string 
help_message_title compound_ "Message" 
string 
help_message_title_ integer DwtCString 
type 
help_on_help_title compound_ "Using Help" 
string 
helphelp_label compound _ "Overview" 
string 
helpontitle_label compound __ "Help On" 
string 
helptitle_label compound_ "Help" 
string 
history_box_label compound_ "Help Topic History" 
string 
history_label compound_ “History...” 
string 
keyword_label compound_ — "Keyword..." 
; string 
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UIL Built-In Tables 
B.8 Help Box 


Table B-9 (Cont.) Help Box 








Controls Reasons arguments 
Name | UIL Data Type Default Value 
keywords _ label compound_ "Keyword:” 
| string 
library_spec ‘  compound_: Null 
string 
library_type » integer 1 (text library) 
mapped_when_ boolean True 
managed 
no_keyword_message § compound_ "Couldn't find keyword 
string %s\n" 
no_title_message compound_ "No title to match string 
string %s\n" 
null_library_message compound_ "No library specified\n" 
string 
null_topic_message compound__ "No first topic and overview 
. string topic specified\n" 
overview_topic compound_ Null 
string 
rows integer 20 
save_as_label compound_ "Save As..." 
string 
search_apply_label compound_ "Apply" 
string 
search_keyword_box_ | compound_ "Search Topic Keywords" 
label string 
search_label compound_ "Search" 
. string 
search_title_box_label compound _ "Search Topic Titles" 
. string 
select_all_label . compound_ "Select All" 
- String 
sensitive boolean True 
title compound_ "Help" 
| string 
title_label compound_ "Title..." 
string 
‘titles_label . compound_ "Title:” 
String 
topic_titles_label compound_ "Topic Titles:" 
_ string 


DECLIT AA VAX MG22B 
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Table B-9 (Cont.) Help Box 


Controls Reasons © 
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translations 


user_data. . 
view_label 


visit_glossary_label 
visit_label . 
visittopic_label 


x 


Arguments 
UIL Data Type 


translation_. 
table 


any 


compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
string 


integer 


integer 


Default Value 


Default translation table 
syntax 
Null ~ 


"View" 

"Visit Glossary" 

"Visit" 

"Visit topic" 

Determined by geometry 


manager 


Determined by geometry 
manager 


Bo 





Label Widget 


UIL Built-In Tables 


B.9 Label Widget 


Table B-10 shows the eoutrols: reasons, and arguments supported by the 


label widget. 


Table B-10 Label Widget 














Controls. Reasons prguments 
A _Name UIL Data Type Default Value 
No children are . . create alignment integer DwtAlignmentCenter 
‘supported : 
pe destroy background_color color Default background color 
help background_pixmap pixmap Null 
border_color ~ color _ Default foreground color 
border_pixmap | -pixmap Null. 
~ border_width integer — 0 pixels 
conform_to_text _ boolean True (if widget created. 
| 3 without width and height); 
False (if widget created . 
ges . with width and height) 
- direction_r_to_| boolean False 
font_argument - font_table Default system font — 
| foreground_color _ color Default foreground color 
height’ integer 0 pixels 
‘highlight_color color Default foreground color 
-— highlight_pixmap _ pixmap Null 
- label_label compound_ Object name 
i _ String | 
label_label_type integer DwtCString 
~ label_pixmap © pixmap Null 
mapped_when_ boolean - True 
managed . 
margin_bottom - integer 0 pixels 
margin_height — integer 2 pixels (text); 0 peels 
fe betes ve a (pixmap) 
‘margin_left su integer 0 pixels 
margin_right - integer — 0 pixels 
margin_top integer 0 pixels 
‘margin_width integer 2 pixels (text); 0 pixels 


(pixmap) . 


1 For the widget variant, the default value for the height and width arguments depends on the setting of the conform_to_text 
argument. If conform_to_text is false, height and width are 0 pixels. Hi conform_to_text is true, height and width are as large as 


needed to hold the label text. 
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Table B-10 (Cont.) Label Widget 











Controls Reasons , lah 

Name UIL Data Type Default Value 

sensitive oe boolean True 

translations translation_ Default translation table 

table syntax 

user_data any Null 

widget_direction integer False 

width’ integer 0 pixels 

X integer Determined by geometry 
manager 

y , . integer Determined by geometry 

manager 





' For the widget variant, the default value for the height and width arguments depends on the setting of the conform_to_text 
argument. If conform_to_text is false, height and width are 0 pixels. If conform_to_text is true, height and width are as large as 
needed to hold the label text. 
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Label Gadget 


Table B—11 shows the controls, reasons, and arguments supported by the 
label gadget. 


Table B—11_ Label Gadget 








Controls Reasons Arguments 
Name UIL Data Type Defauit Value 
No children are create alignment integer DwtAlignmentCenter 
supported 
destroy border_width integer 0 pixels 
help direction_r_to_| boolean False 
height integer 0 pixels 
label_label . compound_ Object name 
string 
sensitive boolean True 
_ widget_direction integer False 
width integer 0 pixels 
Xx integer Determined by geometry 
manager 
y integer Determined by geometry 
manager 
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List Box 


Table B-12 shows the controls, reasons, and arguments sippored by the 
list box widget. 


Table B-12 List Box 











Controls Reasons avoument’s 
Name UIL Data Type Default Value 
No children are create background_color color Default background color 
supported 
destroy background_pixmap pixmap Null 
extend border_color color Default foreground color 
extend_ border_pixmap pixmap Null 
confirm 
help border_width integer 1 pixel 
single create_horizontal_ boolean Null 
scroll_bar 
single_ direction_r_to_| boolean False 
confirm 
font_argument font_table Default system font 
height integer As large as needed to hold © 
. number of items specified 
by visible_items_count 
without exceeding parent 
widget size 
items string_table Null 
mapped_when_ boolean ‘True 
managed . 
margin_height integer 4 pixels 
margin_width integer 10 pixels” 
resize! integer DwtResizeGrowOnly . 
resize_mode' integer DwtResizeGrowOnly 
selected_items string_table ‘Null 
sensitive boolean True 
single_selection boolean True 
spacing integer 1 pixel 
translations translation_ Default translation table 
table syntax: 





1 The resize argument for the list_box object does not support the value DwtResizeShrinkwrap. You can speci the value 
TRUE for DwtResizeShrinkwrap or the value FALSE for DwtResizeFixed. 
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Table B-12 (Cont.) List Box 








Controls Reasons Arguments 
Name . UIL Data Type Default Value 
user_data any Null 
visible_items_count integer 1 
width integer As long as needed to 


hold longest item without 
exceeding parent widget 


size 

X integer Determined by geometry 
manager 

y integer Determined by geometry 
manager 
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Main Window 





Table B-13 shows the controls, reasons, and arguments supported by the 
_ main window widget. - 


Table B-13_ Main Window 











scroll_window 


Controls Reasons : etoumene 
Name VIL Data Type Default Value 
attached_dialog_box create accept_focus boolean False . . 
caution_box “destroy - background_color color Default background color 
color_mix focus background_pixmap —_—pixmap Null | 
command_window help border_color color Default foreground color 
compound_str_txt | border_pixmap ~ pixmap Null 
dialog_box border_width integer 1 pixel 
file_selection ‘direction_r_to_| — boolean » False 
help_box foreground_color color Default foreground color 
label’ height integer 5 pixels 
list_box main_command_ . object Null 
window . . _ reference 
main_window main_horizontal_scroll_ object Null 
bar ‘a - reference 
menu_bar main_menu_bar object Null 
. reference 
message_box main_vertical_scroll_. object - Null 
' bar - reference 
option_menu main_wark_window object Null 
reference 
-popup_attached_db mapped_when__ boolean True 
. managed 
popup_dialog_box sensitive boolean True 
popup_menu ~ translations translation Default translation table 
table syntax 
pulidown_entry' —user_data any Null 
pulldown_menu width | integer 5 pixels 
push_button' x integer Determined by geometry 
manager 
radio_box y integer Determined by geometry 
manager 
scale 
scroll_bar 





‘Gadget variant is not supported. 
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Table B-13 (Cont.) Main Window 











Controls | Reasons | _ Arguments | 
Name _- UIL Data Type Default Value 
selection : 
separator’ 
simple_text 


toggle_button' 
user_defined 
window 
work_area_menu 
| work_in |_ progress_box 





'Gadget variant is not supported. 
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Menu Bar 


‘Table B-14 shows the controls, reasons, and arguments supported by the 
menu bar widget. 


Table B—-14 Menu Bar 


Controls Reasons 
label" create 
pulldown_entry' destroy 
push_button’ entry 
separator’ help 
toggle_button' map 
user_defined unmap 


Name 


adjust_margin 
background_color 
background_pixmap 
border_color 
border_pixmap 
border_width 
change_vis_atts 
direction_r_to_| 
entry_alignment 
entry_border_width 
font_argument 
height 


mapped_when_ 
managed 


margin_height 


margin_width 
menu_alignment 
menu_extend_last_row 
menu_help_widget 


menu_history 


menu_num_columns 
menu_packing 


menu_radio 


Arguments 
UIL Data Type 


boolean 
color 
pixmap 
color 
pixmap 
integer 
boolean 
boolean 
integer 
integer 
font_table 
integer 


boolean 


integer 


integer 
boolean 
boolean 


object 
reference 


object 
reference 


integer 
integer 


boolean 


Default Value 


True 

Default background color 
Null 

Default foreground color 
Null 

1 pixel 

True 

False 
DwtAlignmentBeginning 
0 

Default system font 


16 pixels or the number of 
lines needed to display all 
entries 


True 


3 pixels (vertical 
orientation); 0 pixels 
(horizontal orientation) 


3 pixels 
True 
True 
Null 


Null 


1 


DwtmenuPackingColumn 
(radio boxes); 
DwtmenuPackingTight 
(all others) 


True (radio boxes); False 
(all others) 





‘Widget and gadget variants are supported. 
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‘Table B-14 (Cont.) Menu Bar 








Controls ' Reasons prgumente 

Name UIL Data Type | Default Value 

orientation integer _ DwtOrientationVertical 

radio_always_one ~ boolean True 

sensitive boolean True 

spacing integer 1 pixel (vertical orientation); — 
0 pixels (horizontal 

orientation) 
translations translation Default translation table 
table syntax 
user_data any ._ . Null 
width integer 16 pixels or the width of 
~. parent widget 

X integer Determined by geometry 
manager 

y integer Determined by geometry 
manager 
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Message Box 


Table B-15 shows the controls, reasons, and arguments supported by the 


Table B—15 Message Box 


_ message box widget. 








Controls Reasons qtoumems 
Name UIL Data Type Default Value 
No children are create accelerators translation_ Null 
supported table 
destroy auto_unmanage boolean True 
focus auto_unrealize boolean False 
help background_color color Default background color 
map background_pixmap pixmap Null 
unmap border_color color Default foreground color 
yes border_pixmap pixmap Null 
border_width integer 1 pixel 
default_position boolean False 
direction_r_to_! boolean False 
font_argument font_table Default system font 
height integer 5 pixels or as large as 
needed to hold children 
icon_pixmap pixmap Null 
label_alignment integer DwtAlignmentCenter 
label_label compound_ Object name 
string 
mapped_when_ boolean True 
managed 
margin_height integer 10 pixels 
margin_width integer 12 pixels 
no_resize boolean True 
ok_label compound_ "Acknowledged" 
string 
resize integer Shrink-wrap 
(DwtResizeShrinkWrap) 
resize_mode integer Shrink-wrap 
(DwtResizeShrinkWrap) 
second_label compound_ Null 
string 
~ second_label_ integer DwtAlignmentBeginning 
alignment 





(continued on next page) 


Table B-15 (Cont.) Message Box 


Controls 


Reasons 


sensitive 


style 
take_focus 
title 


translations 


user_data 
width 


VIL Built-In Tables 


Arguments 
UIL Data Type 
boolean 
integer 
boolean 


-compound_ 


string 


translation_ 
table 


any 
integer 


integer 


integer 


B.14 Message Box 


Default Value 


True 

Modal (DwtModal) 
False 

Object name 


Default translation table 
syntax 


Null 


5 pixels or as large as 
needed to hold children 


Determined by geometry 
manager 


Determined by geometry 
manager 
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B.15 Option Menu 


Table B—~16 shows the controls, reasons, and aeument supported by the 
option menu widget. _ 


Table B—16 Option Menu 





Controls Reasons , Arguments. fet 
| Name | | | ___UIL Data Type Default Value 
pulldown_menu - Create background_color _—color Default background color - 
user_defined destroy background |_pixmap | pixmap Null | 
entry — border_color color - Default Cee color _ 
help ~ border_pixmap pixmap  ————sNul 7 
map oe border_width ‘integer 0 pixels _ 
unmap change_vis_atts boolean True 
- direction_r_to_! boolean False 
entry_alignment integer DwtAlignmentEeginning - 
entry_border_width integer S02 in .. Bs 
font_argument _ font_table Default system font 
height integer 16 pixels or as large as | 
ds eo needed to hold children 
label_label compound_ Objectname 
string 
ny when. | boolean True 
managed . 
margin_height integer 3 pixels . 
margin_width = integer 3 pixels 
menu_alignment boolean True 
menu_history : object . Null 
reference 
sensitive boolean — True 
translations translation_ Default translation table 
; table syntax . 
user_data any Null . 
. width integer 16 pixels or as large as 
_ needed to hold children 
x — integer Determined by geometry — 
manager | 
y - integer Determined by geometry 
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manager 





B.16 


Popup Attached Dialog Box 
Table B-17 shows the controls, reasons, and arguments supported by the 


popup attached dialog box widget. 


Table B-17 Popup Attached Dialog Bo 


UIL Built-In Tables 


B.16 Popup Attached Dialog Box 








‘Widget and gadget variants are supported. 


Controls Reasons etounen 
Nam UIL Data Type Default Value 
attached_dialog_box create accelerators . translation_ Null 
table 
_ caution_box destroy : adb_bottom_ integer DwtAttachNone 
. attachment 
color_mix | focus adb_bottom_offset integer 0 
command_window | help adb_bottom _ position integer 0 
compound_str_txt map adb_bottom_widget object Null 
reference 
dialog__box unmap adb_left_attachment integer DwtAttachNone 
file_selection adb_left_offset integer 0 | 
help_box adb_left_position integer 0 
_ label’ adb_left_widget object Null 
. ss reference 
list_box adb_right_attachment integer DwtAttachNone 
main_window adb_right_offset integer 0 
menu_bar adb_right_position integer 0 
message_box adb_right_widget object Null 
7. reference 
option_menu adb_top_attachment integer DwtAttachNone 
popup_attached_db adb_top_offset integer 0 
popup_dialog_box adb_top_position integer 0 
popup_menu adb_top_widget object Null 
. . reference 
pulldown_entry' auto_unmanage boolean True 
pulldown_menu auto_unrealize boolean False 
push_button’ background_color color Default background color 
radio_box - background_pixmap pixmap Null 
scale border_color color Default foreground color 
scroll_bar border_pixmap pixmap Null 
scroll_window border_width integer 1 pixel 
selection | cancel_button object Null 
reference 


(continued on next page) 
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Table B-17 (Cont.) Popup Attached Dialog Box 








Controls Reasons Arguments 
Name | __-UIL Data Type Default Value 
separator’ default_button object Null 
reference 
simple_text default_horizontal_ integer 0 pixels 
. offset 
toggle_button’ default_position boolean | False 
user_defined default_vertical_offset integer 0 pixels 
window direction_r_to_| boolean False 
work_area_menu font_argument font_table Default system font 
work_in_progress_box fraction_base integer 100 
grab_merge_ translation__ Default translation table 
translations. table syntax 
height integer 5 pixels or as large as 
. needed to hold children 
mapped_when_ boolean - True 
. Managed 
-margin_height integer 3 pixels 
margin_width integer 3 pixels 
no_resize boolean True 
resizable boolean True 
resize integer DwtResizeGrowOnly 
resize_mode integer DwtResizeGrowOnly 
rubber_positioning boolean False 
sensitive boolean True 
style - integer DwtModeless 
take_focus boolean True (modal); False 
: (modeless) 
text_merge_ translation_ Null 
translations table 
title compound_ Object name 
string 
translations translation Default translation table 
table syntax 
units integer DwtFontUnits 
user_data any Null 
width integer 5 pixels or as large as 


needed to hold children 





‘Widget and gadget variants are supported. 
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Table B-17 (Cont.) Popup Attached Dialog Box 


Controls 7 Reasons arguments 
Name ; UIL Data Type Default Value 
x integer Determined by geometry 
manager 
yo. integer Determined by geometry 
manager 
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Popup Dialog Box 


Table B-18 shows the controls, reasons, and arguments supported by the 
popup dialog box widget. _ 


Table B-18 Popup Dialog Bo 





Controls - Reasons 
attached_dialog_box create 
caution_box destroy 
color_mix focus 
command_window help 
compound_str_txt map 
dialog_box unmap 
file_selection 

help_box 

label’ 

list_box 

main_window 

menu_bar 

message_box 

option_menu 


popup_attached_db 


popup_dialog_box 
popup_menu 


pulldown_entry' 
pulldown_menu 
push_button' 
radio_box 
scale 
scroll_bar 
scroll_window 
selection 


'Widget and gadget variants are supported. 


accelerators — 


auto_unmanage 
auto_unrealize 
background_color 
background_pixmap 
border_color 
border_pixmap 
border_width 
cancel_button 


child_overlap 
default_button 


default_position 
direction_r_to_| 


font_argument 


grab_merge_ 
translations 


height 


mapped_when_ 
managed 


margin_height 
margin_width 
no_resize 
resize 
resize_mode 
sensitive 

style 


take_focus 


Arguments 


UIL Data Type Default Value 


translation__ Null 

table 

boolean True 

boolean False 

color Default background color 

pixmap Null 

color Default foreground color 

pixmap Null 

integer 1 pixel 

object Null 

reference 

boolean True 

object Null 

reference 

boolean False 

boolean False 

font_table Default system font 

translation_ Default translation table 

table syntax 

integer 5 pixels 

boolean True 

integer 3 pixels 

integer 3 pixels 

boolean True 

integer DwtResizeGrowOnly 

integer DwtResizeGrowOnly 

boolean True 

integer DwtModeless 

boolean True(modal); False 
(modeless) 
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Table B—18 (Cont.) Popup Dialog Box 








Controls Reasons , Ranta moune tbe 
Name === —_—sCUdIL. Data Type Default Value 
separator' : | . text_merge, translation. © ‘Null 
translations table. 
simple_text title Ae compound_ - Object name 
string . 
toggle_button’ translations . translation__ Default translation table 
. table syntax 
user_defined units integer DwtFontUnits 
window ~ . | userdata. === = = © any Null 
work_area_menu width — integer 5 pixels 
work_in_progress_box xX _ integer - Determined by geometry 
. “ 2 ss Manager 
y . integer _ Determined by geometry 
Oe a manager 





‘Widget and gadget variants are supported. 
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Popup Menu 


Table B—19 shows the controls, reasons, and arguments supported by the 
popup menu widget. 


Table B-19 Popup Menu 


Controls 


label" 
pulldown_entry' 
push_button' 
separator’ 
toggle_button' 
user_defined 


‘Widget and gadget variants are supported. 


Reasons 


create 
destroy 
entry 
help 
map 
unmap 


Name 


adjust_margin 
background_color 
background_pixmap 
border_color 
border_pixmap 
border_width 
change_vis_atts 
direction_r_to_| 
entry_alignment 
entry_border_width 
font_argument 
height 


mapped_when_ 
managed 


margin_height 
margin_width 
menu_alignment 
menu_entry_class 


menu_extend_last_row 


menu_help_widget 
menu_history 


menu_is_ 
homogeneous 


menu_num_columns 
menu_packing 


Arguments 
UIL Data Type 


boolean 
color 
pixmap 
color 
pixmap 
integer 
boolean 
boolean 
integer 
integer 
font_table 
integer 


boolean 


integer 
integer 
boolean 


class_rec_ 
name 


boolean 


object 
reference 


object 
reference 


boolean 


integer 
integer 


Default Value 


False 

Default background color 
Null 

Default foreground color 
Null 

0 pixels 

True 

False 
DwtAlignmentBeginning 
0 pixels 

Default system font 


16 pixels or as large as 
needed to hold children: 


True 


3 pixels 
3 pixels 
True 
Null 


True 
Null 


Null 


True (radio boxes); False 
(all others) 
1 row or column 


DwtmenuPackingColumn 
(radio boxes); 
DwtmenuPacking Tight 
(all others) 
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Table B—19 (Cont.) Popup Menu 











Controls Reasons erauments 
Name UIL Data Type Default Value 
menu_radio boolean True (radio boxes); False 
(all others) 

orientation integer DwtOrientationVertical 

radio_always_one boolean True 

sensitive boolean True 

spacing integer 1 pixel 

translations translation__ Default translation table 
table syntax 

user_data any Null 

width integer 16 pixels or as large as 


needed to hold children 
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Pulldown Menu Entry Widget 


Table B—20 shows the controls, reasons, and arguments supported by the 
pulldown menu entry widget. | 


Table B-20 Pulldown Menu Entry Widget 








Controls Reasons foun 
Name UIL Data Type Default Value 
pulldown_menu alignment integer DwtAlignmentCenter 
user_defined background_color color Default background color 
. background_pixmap pixmap Null | 
border_color color _ Default foreground color — | 
border_pixmap pixmap Null | 
border_width integer 0 pixels 
conform_to_text boolean True (if width and height 
not specified); False 
(otherwise) 
direction_r_to_| boolean False 
font_argument font_table Default system font 
foreground_color color Default foreground color 
height integer 0 pixels, or (label or 
pixmap height) + (2 * 
margin height) 
highlight_color color Default foreground color 
highlight_pixmap pixmap Null 
hot_spot_pixmap pixmap Null 
label_label compound_ Object name 
string 
label_label_type integer DwtCString 
label_pixmap pixmap Null 
mapped_when_ boolean True 
managed 
margin_bottom integer 1 pixel 
margin_height integer 2 pixels (text); 0 pixels 
(pixmap) 
margin_left integer 9 pixels 
margin_right integer 7 pixels 
margin_top integer 2 pixels 
margin_width integer 2 pixels (text); 0 pixels 


- (pixmap) 
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Table B-20 (Cont.) Pulldown Menu Entry Widget 





Controls Reasons arguments 

Name UIL Data Type Default Value 

sensitive boolean True 

translations translation_ Default translation table 

table syntax 

user_data any Null 

width integer 0 pixels, or (label width + 
hotspot pixmap width) + (2 
* margin width) 

x integer Determined by geometry 
manager 

y integer Determined by geometry 


manager 
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Pulldown Menu Entry Gadget 


Table B—21 shows the controls, reasons, and arguments supported by the 
pulldown menu entry gadget. 


Table B—21 Pulldown Menu Entry Gadget 


Controls Reasons Arguments 
Name UIL Data Type Default Value 
pulldown_menu activate alignment integer DwtAlignmentCenter 
user_defined create border_width integer 0 pixels 
destroy height integer 0 pixels, or (label or 
pixmap height) + (2 * 
margin height) 
help label_label compound_ Object name 
. string 
pulling sensitive boolean True 
width integer 0 pixels, or (label width + 
hotspot pixmap width) + (2 
* margin width) 
X integer Determined by geometry 
manager 
y integer Determined by geometry 
manager 
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Pulldown Menu 


Table B—22 shows the controls, reasons, and arguments supported by the 


pulldown menu widget. 


Table B-22 Pulldown Menu 











Controls Reasons Arguments 
Name UIL Data Type Default Value 
label’ create adjust_margin boolean True 
pulldown_entry' destroy background_color color Default background color 
push_button' entry background_pixmap pixmap Null 
separator’ help border_color color Default foreground color 
toggle_button’ map border_pixmap pixmap Null 
user_defined unmap border_width integer 0 
change_vis_atts boolean True 
direction_r_to_| boolean False 
entry_alignment integer DwtAlignmentBeginning 
entry_border_width integer 0 
font_argument font_table Default system font 
foreground_color color Default foreground color 
height integer 16 pixels or as large as 
needed to hold children 
highlight_color color Default foreground color 
mapped_when_ boolean True 
managed 
margin_height integer 2 pixels 
margin_width integer 2 pixels 
menu_alignment boolean True 
menu_entry_ class class_rec_ Null 
name 
menu_extend_last_row boolean True 
menu_help_widget object Null 
reference 
menu_history object Null 
reference 
menu_is_ boolean True (radio boxes); False 
homogeneous (all others) 
menu_num_columns integer 1 row or column 


‘Widget and gadget variants are supported. 
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Table B-22 (Cont.) Pulldown Menu 








Controls Reasons Arguments 

Name UIL Data Type Default Value 

menu_packing integer DwtmenuPackingColumn 
(radio boxes); 
DwtmenuPacking Tight 
(all others) 

menu_radio boolean False 

orientation integer DwtOrientationVertical 

radio_always_one boolean True 

sensitive boolean True 

spacing integer 0 pixels 

translations translation_ Default translation table 

table syntax 
user_data any Null 
width integer 16 pixels or as large as 


needed to hold children 





~B.22 


Push Button Widget 


Table B—23 shows the controls, reasons, and arguments supported by the 
push button widget. 


Table B-23 Push Button Widget 


UIL Built-In Tables 


B.22 Push Button Widget 





- Controls 


No children are 


supported 


' For a push button widget, if shadow is true, the default value for border_width is 0 pixels. 


Reasons 


activate 


arm 
create 
destroy 
disarm 
help 


accelerator_text 


alignment 
background_color 
background_pixmap 
border_color 
border_highlight 
border_pixmap 
border_width' 
button_accelerator 
conform_to_text 


direction_r_to_| 
fill_highlight 
font_argument 
foreground_color 


height 


highlight_color 
highlight_pixmap 
insensitive_pixmap 


| label_label 


label_label_type 
label_pixmap 


mapped_when_ 
managed 


margin_bottom 
margin_height 


Arguments 


UIL Data Type Defauit Value 


compound_ 


string 
integer 
color 
pixmap 
color 
boolean 
pixmap 
integer 


‘String 


boolean 


boolean 
boolean 
font_table 
color 
integer 


color 
pixmap 
pixmap 


compound_ 


string 
integer 
pixmap 
boolean 


integer 
integer 


Null 


DwtAlignmentCenter 
Default background color 
Null 

Default foreground color 
False 

Null 

1 pixel 

Null 


True (if widget created 
without width and height); 
False (if widget created 
with width and height) 


False 

False 

Default system font 
Default foreground color 


0 pixels, or (label or 
pixmap height) + (2 * 
margin height) 


Default foreground color 
Null 

Null 

Object name 


DwtCString 
Null 
True 


1 pixel 
4 pixels (text); 0 pixels 
(pixmap) 
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Table B-23 (Cont.) Push Button Widget 





Controls Reasons Arquinents 

Name _ UIL Data Type Default Value 

margin_left integer a: pixels 

margin_right integer 7 pixels 

margin_top integer 2 pixels 

margin_width integer 10 pixels (text); 0 pixels 

. (pixmap) 

sensitive boolean True 

shadow boolean True 

translations transiation_ Default translation table 

table syntax 

user_data any Null 

widget_direction integer False 

width integer 0 pixels, or (label or 
pixmap width) + (2 * 
margin width) 

Xx integer Determined by geometry 
manager 

y integer Determined by geometry 
manager 
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Push Button Gadget 


Table B—24 shows the controls, reasons, and arguments supported by the 
push button gadget. 


Table B—24 Push Button Gadget 





Controls 


Name 


Arguments 


UIL Data Type 


Default Value 





No children are 


supported 


accelerator_text 


alignment 


border_width 
button_accelerator 
~ direction_r_to_| 


height . 


label_label 


sensitive 


widget_direction 


width 


compound _ 


string 
integer 
integer 
string 
boolean 
integer 


compound _ 


string 
boolean 
integer 
integer 


integer 


integer 


Null 


DwtAlignmentCenter 
1 pixel 

Null 

False 


0 pixels, or (label or 
pixmap height) + (2 * 
margin height) 


Object name 


True 
False 


0 pixels, or (label or 
pixmap width) + (2 * 
margin width) 
Determined by geometry 
manager 


Determined by geometry 
manager 
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Radio Box 
‘Table B-25 shows the controls, reasons, and arguments supported by the 
radio box widget. 


Table B-25 Radio Box 











Controls — Reasons _ , ik aloe 
Name VIL Data Type Default Value 
label’ “2 - create adjust_margin boolean True 
pulldown_entry' destroy background_color color Default background color 
push_button' entry background_pixmap pixmap Null 
separator’ help border_color | _ color Default foreground color 
toggle_button' map border_pixmap pixmap Null 
user_defined unmap — border_width integer 0 pixels 
change_vis_atts boolean True 
 direction_r_to_| boolean False 
~ entry_alignment integer DwtAlignmentBeginning 
-entry_border_width  _integer _ 0 pixels 
font_argument font_table Default system font 
height oS integer 16 pixels or as large as 
_ needed to hold children 
mapped_when_ boolean True 
managed 
margin_height integer 3 pixels 
margin_width integer 3 pixels 
menu_alignment boolean True 
menu entry_ class class_rec_ Null 
name 
menu_extend_last_row boolean True 
_ menu_help_widget object Null 
. reference 
menu_history object Null 
reference 
menuwlis_ boolean False 
homogeneous 
menu_num_columns integer 1 
menu_packing integer DwtnenuPackingTght 
~ menu_radio boolean — True 
orientation integer DwtOrientationVertical 
radio_always_one boolean _ True 





‘Widget and gadget variants are supported. 
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Table B-25 (Cont.) Radio Box 


Controls 


Reasons 


Name 
sensitive 
spacing 
translations 


user_data 
width 


UIL Built-In Tables 


_ Arguments 


UIL Data Type 


boolean 
integer 


~~ translation_ 


table 
any 
integer 


integer 


integer 


_B.24 Radio Box 


Default Value 


True 

1 pixel 

Default translation table 
syntax 

Null 


16 pixels or as large as 
needed to hold children 


Determined by geometry 
manager 


Determined by geometry 
manager 
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Scale 


Table B—26 Scale 


Table B—26 shows the controls, reasons, and arguments supported by the 


scale widget. 











Controls Reasons erguments 
Name UIL Data Type Default Value 
attached_dialog_box create background_color color Default background color 
caution_box destroy background_pixmap pixmap Null 
color_mix drag border_color color Default foreground color 
command_window help border_pixmap pixmap Null 
compound_str_txt value_ border_width integer 0 pixels 
changed 
dialog_box decimal_points integer 0 
file_selection direction_r_to_| boolean False 
help_box font_argument font_table Default system font 
label’ foreground_color color Default foreground color 
list_box height integer Calculated based on scale 
width or height, label 
widths, and orientation 
main_window highlight_color color Default foreground color 
menu_bar highlight_pixmap pixmap Null 
message_box mapped_when_ boolean True 
managed 
option_menu max_value integer 100 
popup_attached_db min_value integer 0 
popup_dialog_box orientation integer DwtOrientationHorizontal 
popup_menu scale_height integer 20 pixels 
pulldown_entry’ scale_value integer As close to 0 as possible 
pulldown_menu scale_width integer 100 pixels 
push_button' sensitive boolean True 
radio_box show_value boolean True 
scale show_value_automatic boolean True 
scroll_bar slider_color color Default foreground color 
scroll_window slider_pixmap pixmap Null 
selection title compound _ Scale name 
string 
separator’ translations translation_ Default translation table 
table 


syntax 





‘Gadget variant is not supported. 
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B.25 Scale 
Table B-26 (Cont.) Scale 
Controls Reasons Arguments 
Name UIL Data Type Default Value 
simple_text user_data any Null 
toggle_button' width integer Calculated based on scale 
width or height, label 
widths, and orientation 
user_defined Xx integer Determined by geometry 
manager 
window y integer Determined by geometry 
manager 


work_area_menu 
work_in_progress_box 





‘Gadget variant is not supported. 
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Scroll Bar 


‘Table B-27 shows the controls, reasons, and arguments supported by the 
scroll bar widget. 


Table B—27 Scroll Bar 








Controls Reasons erounent 
Name UIL Data Type Default Value 
No children are create background_color color Default background color 
supported 
destroy background_pixmap pixmap Null 
drag border_color color Default foreground color 
help border_pixmap pixmap Null 
page_dec border_width integer 1 pixel 
page_inc | direction_r_to_! boolean False 
to_bottom foreground_color color Default foreground color 
to_top height integer height of parent - 17 
units (vertical orientation); 
height of parent + 17 units 
(horizontal orientation) 
unit_dec highlight_color color Default foreground color 
unit_inc highlight_pixmap pixmap Null 
value_ mapped_when_ boolean ‘True 
changed managed 
max_value integer 100 
min_value integer 0 
orientation integer DwtOrientationVertical 
scroll_bar_inc integer 10 units 
scroll_bar_page_inc integer 10 units 
scroll_bar_value integer 0 
sensitive boolean True 
show_arrows boolean True 
shown integer 10 units 
slider_color color Default foreground color 
slider_pixmap pixmap Null 





(continued on next page) 
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-B.26 Scroll Bar 


Table B-27 (Cont.) Scroll Bar — 





v 








Controls — Reasons | Arguments 
| | Name —  UIL Data Type Default Value 
translations translation_ Default translation table 
o table syntax 
-user_data any Null 
width integer _ width of parent + 17 


units (vertical orientation); | 
width of parent - 17 units 
(horizontal orientation) 


x integer Determined by geometry 
, manager 
y 7 integer Determined by geometry 
2 manager - 
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Scroll Window 


Table B—28 shows the controls, reasons, and arguments supported by the 
scroll window widget. 


Table B—28 Scroll Window 





Controls 


attached_dialog_box 
caution_box 
color_mix 
command_window 
compound_str_txt 
dialog_box 
file_selection 

help box 

label! 


list_box 


main_window 
menu_bar 


message_box 
option_menu 


popup_attached_db 
popup_dialog_box 


popup_menu 
pulldown_entry' 
pulldown_menu 
push_button' 


radio_box 


Reasons 


create 
destroy 
help 


Name 


background_color 
background_pixmap 
border_color 
border_pixmap 
border_width 
direction_r_to_| 
foreground_color 
height 


horizontal_scroll_bar 


mapped_when_ 
managed 


sensitive 


shown_value_ 
automatic_horiz 


shown_value_ 
automatic_vert 
translations 


user_data 
vertical_scroll_bar 


width 


work_window 


Arguments 


UIL Data Type Default Value 


color 
pixmap 
color 
pixmap 
integer 
boolean 
color 
integer 


object 
reference 


boolean 


boolean 
boolean 


boolean 


translation_ 


table 
any 


object 
reference 


integer 
object 
reference 


integer 


integer 


Default background color 
Null 

Default foreground color 
Null 

1 pixel 

False 

Default foreground color 


Height of work area 
window + height of 
horizontal scroll bar 


Null 
True 


True 
True 


True 


Default translation table 
syntax 


Null 
Null 


Width of work area window 
+ width of vertical scroll bar 


Null 


Determined by geometry 
manager 


Determined by geometry 
manager 





'Gadget variant is not supported. 
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Table B—28 (Cont.) Scroll Window 


Controls Reasons 
Name 

scale 

scroll_bar 

scroll_window 

selection 

separator’ 

simple_text 

toggle_button’ 

user_defined 

window 

work_area_menu 

work_in_progress_box 


UIL Built-In Tables 
B.27 Scroll Window 


Arguments 


UIL Data Type Default Value 





'Gadget variant is not supported. 
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Selection 


Table B—29 shows the controls, reasons, and arguments sipieaaa by the 
selection widget. | 


Table B—29 Selection 








Controls Reasons proument? 
Name UIL Data Type Default Value 
attached_dialog_box activate accelerators translation__ Null 
table 
caution_box cancel auto_unmanage boolean True 
color_mix create auto_unrealize boolean False | i. 
command_window _ destroy background_color color Default background color 
compound_str_txt focus. background_pixmap pixmap Null 
dialog box — help border_color color Default foreground color _ 
-- file_selection ‘map border_pixmap pixmap Null 
help_box | no_match — border_width ‘integer 1 pixel 
label! unmap cancel_labe! compound_ _. "Cancel" 
string 
_ list_box default_position boolean False 
main_window | direction_r_to_| boolean False 
menu_bar file_to_extern_proc any Null 
message_box file_to_intern_proc | any Null ; 
option_menu - font_argument font_table Default system font 
_ popup_attached_db height integer - 5 pixels or as large as 
needed to hold children 
popup_dialog_box items string_table Null | 
popup_menu label_label compound_ "Items" 
string ; 
pulldown_entry' mapped_when_ boolean True 
managed . 
pulldown_menu margin_height integer 2 pixels 
push_button' margin_width integer 2 pixels 
radio_box must_match boolean False 
scale no_resize - boolean True 
scroll_bar ok_label compound_ "Ok" 
. string 
scroll_window resize integer Grow only ; 
(DwtResizeGrowOnly) 





‘Gadget variant is not supported. 
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~B.28 Selection 


~ Table B-29 (Cont.) Selection 





Controls Reasons Argumems 
Name UIL Data Type Default Value 
selection resize_mode integer Grow only 
. (DwtResizeGrowOnly) 
separator’ gente ae selection_label compound_ "Selection" 
string 
simple_text | ~ selection_value compound_ Null 
string 
toggle_button' sensitive boolean True 
user_defined style integer Modal (DwtModal) 
window - take_focus boolean True (modal); False 
. (modeless) 
work_area_menu text_cols integer 30 
work_in_progress_box title compound_ "Open" 
string 
translations translation_ Default translation table 
table syntax 
user_data any Null 
visible_items_count integer 8 
width integer 5 pixels or as large as 
needed to hold children 
integer Centered in parent 
y integer Centered in parent 





‘Gadget variant is not supported. 
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Separator Widget 


Table B—30 shows the controls, reasons, and arguments supported by the 
separator widget. 


Table B-30 Separator Widget 





Controls Arguments 
Name UIL Data Type Default Value 
No children are background_color color Default background color 
supported 
background_pixmap pixmap Null 
border_color color Default foreground color 
border_pixmap pixmap Null 
border_width integer 0 pixels 
direction_r_to_| boolean False 
foreground_color color Default foreground color 
height integer Height of parent (vertical 
orientation); 1 pixel 
(horizontal orientation) 
mapped_when_ boolean True 
managed 
margin_bottom integer 0 pixels 
margin_height integer 0 pixels 
margin_left integer 0 pixels 
margin_right integer 0 pixels 
margin_top integer 0 pixels 
margin_width integer 0 pixels 
orientation integer DwtOrientationHorizontal 
sensitive boolean False 
translations translation_ Default translation table 
table syntax 
user_data any Null 
width integer 1 pixel (vertical orientation); 
width of parent (horizontal 
orientation) 
X integer Determined by geometry 
manager 
y integer Determined by geometry 


manager 
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Separator Gadget 


Table B—31 shows the controls, reasons, and arguments supported by the 
separator gadget. 


Table B-31 Separator Gadget 


Controls Reasons : aun 
Name UIL Data Type Default Value 
No children are create border_width — integer 0 pixels 
supported 
destroy height integer Height of parent (vertical 
orientation); 1 pixel 
(horizontal orientation) 
help orientation integer DwtOrientationHorizontal 
sensitive boolean False 
width integer 1 pixel (vertical orientation); 
width of parent (horizontal 
orientation) 
X integer Determined by geometry 
manager 
y integer Determined by geometry 
manager 
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~B.31 Simple Text 





Simple Text 


Table B—32 shows the controls, reasons, and arguments supported by the 
simple text widget. 


Table B-32 Simple Text 





Controls 


No children are 


supported 


Reasons 


activate 


create 
destroy 
focus 
help 
lost_focus 


value_ 
changed 


Name 
auto_show_insertion_ 
point 
background_color 
background_pixmap 
blink_rate 
border_color 
border_pixmap 
border_width 


cols 

editable 
font_argument 
foreground_coior 
half_border 
height 


insertion_point_visible 
insertion_position 


mapped_when_ 
managed 


margin_height 
margin_width 
max_length 


pending_delete 
resize_height 
resize_width 
rows 
scroll_horizontal 
scroll_left_side 
scroll_top_side 


Arguments 


UIL Data Type Default Value 


boolean 


color 
pixmap 
integer 
color 
pixmap 
integer 


integer 
boolean 
font_table 
color 
boolean 
integer 


boolean 
integer 
boolean 


integer 
integer 
integer 


boolean 
boolean 
boolean 
integer 

boolean 
boolean 
boolean 


True 


Default background color 
Null 

500 milliseconds 

Default foreground color 
Null 

1 pixel 


1 

True 

Default system font 
Default foreground color 
True 


(rows * font height) + (2 * 
margin height) 


True 
0 
True 


2 pixels 
2 pixels 


MAXINT; the largest 
number that can fit in 
a C long ((2**31)-1, or 
2,147,483,647) 


True 
True 
True 
20 
False 
False 
False 
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Table B-32 (Cont.) Simple Text 





Controls Reasons .  iguments 

Name UIL Data Type Default Value 

scroll_vertical boolean False 

sensitive ‘boolean © True 

simple_text_value string Null 

top_position integer 0 

translations translation_ Default translation table 
table - syntax 

user_data any Null 

width integer (columns * average 


character width) + (2 * 
margin width) 


word_wrap boolean False. 
x | integer Determined by geometry 
. manager 
y integer Determined by geometry 
. manager 
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Toggle Button Widget 


Table B—33 shows the controls, reasons, and arguments supported by the 
toggle button widget. 


Table B-33 Toggle Button Widget 





Controls Reasons Arguments 
Name UIL Data Type Default Value 
No children are arm accelerator_text compound_ Null 
supported string 
create alignment integer DwtAlignmentCenter 
destroy background_color color Default background color 
disarm background_pixmap pixmap Null 
help border_color color Default foreground color 
value_ border_pixmap pixmap Null 
changed 
border_width integer 0 pixels 
button_accelerator string Null 
conform_to_text boolean True (if widget created 


without width and height); 
False (if widget created 
with width and height) 


direction_r_to_| boolean False 
font_argument font_table Default system font 
foreground_color color Default foreground color 
height" integer 0 pixels 
highlight_color color Default foreground color 
highlight_pixmap pixmap Null 
indicator boolean True (text); False (pixmap) 
insensitive_pixmap_off  pixmap Null 
insensitive_pixmap_on _—_ pixmap Null 
label_label compound_ Object name 

string 
label_label_type integer DwtCString 
label_pixmap pixmap Null 
mapped_when_ boolean True 
managed 
margin_bottom integer 1 pixel 





' For the widget variant, the default value for the height and width arguments depends on the setting of the conform_to_text 
argument. If conform_to_text is false, height and width are 0 pixels. If conform_to_text is true, height and width are as large as 
needed to hoid the label text. 
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Table B-33 (Cont.) Toggle Button Widget 


Controls 


Reasons 


Name 


margin_height 


margin_left 
margin_right 
margin_top 
margin_width 


pixmap_off 
pixmap_on 
sensitive 
shape 
spacing 
toggle_value 
translations 


user_data 
visible_when_off 
widget_direction 
width' 

x 


| VIL Built-In Tables 
B.32 Toggle Button Widget 


Arguments 


UIL Data Type 


integer 


integer 
integer 
integer 
integer 


pixmap 
pixmap 
boolean 
integer 
integer 
boolean 


translation__ 
table 


any 
boolean 
integer 
integer 
integer 


integer 


Default Value 

2 pixels (text); 0 pixels 
(pixmap) 

9 pixels 

7 pixels 

2 pixels 

2 pixels (text); 0 pixels 
(pixmap) 

Null 

Null 

True 

DwtRectangular 

4 pixels 

False 


Default translation table 
syntax 


Null 
True 
False 

0 pixels 


Determined by geometry 
manager 


Determined by geometry 
manager 





' For the widget variant, the default value for the height and width arguments depends on the setting of the conform_to_text 
argument. If conform_to_text is false, height and width are 0 pixels. If conform_to_text is true, height and width are as large as 


needed to hold the label text. 


B.33 


Toggle Button Gadget 


~ UIL Built-In Tables 


B.33 Toggle Button Gadget 


Table B—34 shows the controls, reasons, and arguments supported by the : 
toggle button gadget. 


Table B-34 Toggle Button Gadget 





Controls Reasons niguments 
| Name UIL Data Type Default Value 
No children are create accelerator. text compound_ Null 
supported string 7 
destroy alignment integer DwtAlignmentCenter 
help border_width integer 0 pixels 
value_ button_accelerator string Null — 
changed 
a direction_r_to_| boolean False 
height integer 0 pixels 
label_label compound_ Object name ~ 
string 
sensitive boolean True Z 
shape integer DwtRectangular 
toggle_value boolean False 
widget_direction integer False 
width integer 0 pixels z 
X integer Determined by geometry 
manager ss 
y integer Determined by geometry 


manager 
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User Defined 


Table B—35 shows the controls, reasons, and arguments supported by the 
user defined widget. 


Table B-35 User Defined 








Controls Reasons Arguments 
: Name UIL Data Type Default Value 
attached_dialog_box Allreasons _ All arguments are 
are supported 
ei | supported 
caution_box 
color_mix 


command_window 
compound_str_txt 
dialog_box 
file_selection 
help_box 

label’ 

list_box . 
main_window 
menu_bar - 
message_box 


. option_menu 
popup_attached_db 


popup_dialog_box 
popup_menu 
pulldown_entry' 
pulldown_menu 
push_button' 
radio_box 

scale 

scroll_bar 
scroll_window 
selection 
separator’ 
simple_text 


'Gadget variant is not supported. 


(continued on next page) 


B-67 


UIL Built-In Tables 
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Table B-35 (Cont.) User Defined 


Controls Reasons 


toggle_button' 
user_defined 

window 
work_area_menu 
work_in_progress_box 





'Gadget variant is not supported. 
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Name 


- Arguments 


UIL Data Type 


Default Value 


B.35 


UIL Built-In Tables 
B.35 Window 





Window 


Table B—36 shows the controls, reasons, and arguments supported by the 
window widget. 


Table B-36 Window 





Controls Reasons erouments 
Name UIL Data Type Default Value 
No children are’ create background_color color Default background color 
supported . 
destroy background_pixmap pixmap Null 
expose border_color color Default foreground color 
help border_pixmap pixmap Null 
border_width integer 1 pixel 
direction_r_to_| boolean Faise 
height integer 0 pixels 
mapped_when_ boolean True 
managed 
sensitive boolean True 
translations translation Default translation table 
table syntax 
user_data any Null 
width | integer 0 pixels 
x integer Determined by geometry 
manager 
y integer Determined by geometry 
manager 


B.36 


UIL Built-In Tables 
B.36 Work Area Menu 





Work Area Menu 


Table B-37 shows the controls, reasons, and arguments supported by the 
work area menu widget. | 


Table B-37 Work Area Menu 


Controls 


label’ 
pulldown_entry' 
push_button' 
separator! 
toggle_button' 
user_defined 


Reasons 


create 
destroy 
entry 
help 
map 
unmap 


Name 


adjust_margin 
background_color 
background_pixmap 
border_color 
border_pixmap 
border_width 
change_vis_atts 
direction_r_to_| 
entry_alignment 
entry_border_width 
font_argument 
height 


mapped_when_ 
managed 


margin_height 
margin_width 
menu_alignment 
menu_entry_class 


menu_extend_last_row 


menu_help_widget 
menu_history 


menu_is_ 
homogeneous 


Arguments 
UIL Data Type 


boolean 
color 
pixmap 
color 
pixmap 
integer 
boolean 
boolean 
integer 
integer 
font_table 
integer 


boolean 


integer 
integer 
boolean 


class_rec_ 
name 


boolean 


object 
reference 


object 
reference 


boolean 


Default Value 


False 

Default background color 
Null 

Default foreground color 
Null 

1 pixel 

True 

False 

True 

0 

Default system font 


16 pixels or sum of entry 
window heights + spacing, 
or 10 pixels if there are 
no entry windows (vertical 
orientation); height of 
widest entry window, or 

5 pixels if there are no 
entry windows (horizontal 
orientation) 


True 


3 pixels 
3 pixels 
True 
Null 


True 
True 


Null 


True (radio boxes); False 
(all others) 





‘Widget and gadget variants are supported. 
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Table B-37 (Cont.) Work Area Menu 








- Controls Reasons , 3, ieumems 
Name UIL Data Type Default Value 
menu_num_columns integer 1 row or column 
<< _. . (depending on orientation) 
menu _ packing ~ integer DwtmenuPackingColumn 
(radio boxes); 
DwtmenuPackingTight 
(all others) 
menu_radio boolean True (radio boxes); False 
(all others) 
orientation - integer DwtOrientationVertical 
radio_always_one boolean True 
sensitive boolean True 
spacing integer 0 
translations translation_ Default translation table 
~ table syntax 
user_data any Null 
width integer If orientation is vertical, 
width is the maximum 
. entry width or 16 pixels. 
_ If orientation is horizontal, 
width is the sum of width 
. and spacing or 16 pixels. 
X integer Determined by geometry 
oo manager 
y integer Determined by geometry 


manager 
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Work-in-progress Box 


Table B—38 shows the controls, reasons, and arguments supported by the 
work-in-progress box widget. 


Table B~38 Work-in-progress Box 





Controls Reasons pecianents 
Name UIL Data Type Default Value 
No children are cancel accelerators translation Null 
supported table 
create auto_unmanage boolean True 
destroy auto_unrealize boolean False 
focus background_color color Default background color 
help background_pixmap pixmap Null 
map border_color color Default foreground color 
unmap border_pixmap pixmap Null 
border_width integer 1 pixel 
cancel_label compound_ "Cancel" 
string 
default_position boolean False 
direction_r_to_| boolean False 
font_argument font_table Default system font 
height integer 5 pixels or as large as 
needed to hold children 
icon_pixmap pixmap Null 
label_alignment integer DwtAlignmentCenter 
label_label compound_ Object name 
string 
mapped_when_ boolean True 
managed 
margin_height integer 2 font units 
margin_width integer 2 font units 
no_resize boolean No (no window manager 
resize button) 
resize integer DwtResizeGrowOnly 
resize_mode integer DwtResizeGrowOnly 
second_label compound_ Null 
string 
second_label_ integer DwtAlignmentBeginning 
alignment 
sensitive boolean True 
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Table B-38 (Cont.) Work-in-progress Box 


Controls 


Reasons 


Name 


style 
take_focus 


title 
translations 


user_data 
width 


y 


yes_label 


UIL Built-In Tables 
B.37 Work-in-progress Box 


Arguments 


UIL Data Type 


integer 
boolean 


compound_ 
string 


translation_ 
table 


any 
integer 


integer 
integer 


compound_ 
string 


Default Value 


DwtModal 


True (modal); False 
(modeless) 


Object name 


Default translation table 
syntax 
Null 


5 pixels or as large as 
needed to hold children 


Determined by geometry 
manager 


Determined by geometry 
manager 


"Yes" (DwtSYes) 
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UIL Arguments 


Table B—39 is an alphabetical listing of all XUI Toolkit arguments 
(attributes) supported by UIL. For each argument, Table B~39 shows the 
argument name in the MIT C and VAX bindings. For your convenience, 
the argument’s data type is repeated in this table. See the VMS 
DECwindows Toolkit. Routines Reference Manual for a description of 
each of the supported arguments. 


Table B-39 UIL Arguments 


UIL Name 


about_label 
accelerator_text 
accelerators 


accept_focus 


adb_bottom__ 
attachment 


adb_bottom_ 
offset 


adb_bottom_ 
position 
adb_bottom_ 
widget 
adb_left_ 
attachment 
adb_left_offset 
adb_left_ 
position 
adb_left_widget 
adb_right_ 
attachment 
adb_right_offset 
adb_right_ 
position 
adb_right_ 
widget 
adb_top_ 
attachment 
adb_top_ offset 


adb_top_ 
position 


UiL Data Type 


compound_ 
string 


compound_ 
string 


translation_ 
table 


boolean 
integer 


integer 
integer 
object reference 
integer 


integer 
integer 


object reference 
integer 


integer 
integer 


object reference 
integer 


integer 
integer 


VAX Binding Name 
DWT$C_NABOUT_LABEL 
DWT$C_NACCELERATOR_TEXT 
DWT$C_NACCELERATORS 
DWT$C_NACCEPT_FOCUS 
DWT$C_NADB_BOTTOM_ 
ATTACHMENT 
DWT$C_NADB_BOTTOM_OFFSET 
DWT$C_NADB_BOTTOM_POSITION 
DWT$C_NADB_BOTTOM_ WIDGET 
DWT$C_NADB_LEFT_ATTACHMENT 


DWT$C_NADB_LEFT_OFFSET 
DWT$C_NADB_LEFT_POSITION 


DWT$C_NADB_LEFT_WIDGET | 
DWT$C_NADB_RIGHT_ATTACHMENT 


DWT$C_NADB_RIGHT_OFFSET 
DWT$C_NADB_RIGHT_POSITION 


DWT$C_NADB_RIGHT_WIDGET 
DWT$C_NADB_TOP_ATTACHMENT 


DWT$C_NADB_TOP_OFFSET 


DWT$C_NADB_TOP_POSITION 


MIT C Binding Name 
DwtNaboutLabel 


DwtNacceleratorText 
DwtNaccelerators 


DwtNacceptFocus 
DwtNadbBottomAttachment 


DwtNadbBottomOffset 


DwtNadbBottomPosition 


-DwtNadbBottomWidget 


DwtNadbLeftAttachment 


DwtNadbLeftOffset 
DwtNadbLeftPosition 


DwtNadbLeftWidget 
DwtNadbRightAttachment 


DwtNadbRightOffset 
DwtNadbRightPosition 


DwiNadbRightWidget 
DwtNadb TopAttachment 


DwtNadbTopOffset 
DwtNadbTopPosition 
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UIL Name 


adb_top_widget 
add_topic_label 


adjust_margin 
alignment 


application_ 
name 


apply_label 


auto_show_ 
insertion_point 


auto_unmanage 
auto_unrealize 


back_blue_ 
value 


back_green_ 
value 


back_red_value 


background_ 
color 


background_ 
pixmap 


bad_frame_ 
message 


bad_library_ 
message 


bidirectional_ 
cursor 


black_label 


blink_rate 
blue_label 


border_color 
border_highlight 
border_pixmap 
border_width 


button__ 
accelerator 


UIL Data Type 


object reference 


compound _ 
string 


boolean 
integer 


compound_ 
string 


compound_ 
string 


boolean 


boolean 
boolean 
color 


color 


color 
color 


pixmap 


compound_ 
string 


compound_ 
string 


boolean 


compound_ 
string 


integer 


compound_ 
string 


color 
boolean 
pixmap 
integer 
string 


VAX Binding Name 
DWT$C_NADB_TOP_WIDGET 
DWT$C_NADDTOPIC_LABEL 


DWT$C_NADJUST_MARGIN 
DWT$C_NALIGNMENT 
DWT$C_NAPPLICATION_NAME 


DWT$C_NAPPLY_LABEL 
DWT$C_NAUTO_SHOW_INSERT_ 
POINT 
DWT$C_NAUTO_UNMANAGE 


DWT$C_NAUTO_UNREALIZE 
DWT$C_NBACK_BLUE_VALUE 


DWT$C_NBACK_GREEN_VALUE 


DWT$C_NBACK_RED_VALUE 
DWT$C_NBACKGROUND 


DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NBADFRAME_MESSAGE 
DWT$C_NBADLIB_MESSAGE 
DWT$C_NBIDIRECTIONAL_CURSOR 
DWT$C_NBLACK_LABEL 


DWT$C_NBLINK_RATE 
DWT$C_NBLUE_LABEL 


DWT$C_NBORDER_COLOR 
DWT$C_NBORD_HIGHLIGHT 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBORDER_WIDTH 
DWT$C_NBUTTON_ACCELERATOR: 
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MIT C Binding Name 


DwtNadb TopWidget 
DwtNaddtopicLabel 


DwtNadjustMargin 
DwtNalignment 
DwtNapplicationName 


DwtNapplyLabel 
DwtNautoShowinsertPoint 


DwtNautoUnmanage 
DwtNautoUnrealize 
DwtNbackBlueValue 


DwtNbackGreenValue 


DwtNbackRedValue 
DwtNbackground 


DwtNbackgroundPixmap 
DwtNbadframeMessage 
DwtNbadlibMessage 
DwtNbidirectionalCursor 
DwtNblackLabel 


DwtNblinkRate 
DwtNblueLabel 


DwtNborderColor 
DwtNbordHighlight 
DwtNborderPixmap 
DwtNborderWidth 
DwtNbuttonAccelerator 
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Table B-39 (Cont.) UIL Arguments 


UIL Name 


cache_help_ 
library 


cancel_button 
cancel_label 


change_vis_atts 
child_overlap 
close_label 


color_mode! 
cols 


command_ 
value 


compound_ 
text_value 


conform_to_text 
copy_label 


create_ 
horizontal_ 
scroil_bar 


decimal_points 
default_button 


default_ 
horizontal_ 
offset 


~ default_position 


default_ 
pushbutton 


default_vertical_ 
offset 


dialog_font 
dir_mask 


direction_r_to_| 
dismiss_label 


disp_win_ 
margin 


B-76 


UIL Data Type 


boolean 


object reference 


compound_ 
string 


boolean 
boolean 


compound_ 
string 


integer 
integer 
String 


compound_ 
string 


boolean 


compound_ 
string 


boolean 


integer 
object reference 
integer 


boolean 
integer 


integer 


font_table 


compound_ 
string 


boolean 


compound_ 
string 


integer 


VAX Binding Name 
DWT$C_NCACHE_HELP_LIBRARY 


DWT$C_NCANCEL_BUTTON 
DWT$C_NCANCEL_LABEL 


DWT$C_NCHANGE_VIS_ATTS 
DWT$C_NCHILD_OVERLAP 
DWT$C_NCLOSE_LABEL 


DWT$C_NCOLOR_MODEL 
DWT$C_NCOLS 
DWT$C_NVALUE 


DWT$C_NVALUE 


DWT$C_NCONFORM_TO_TEXT 
DWT$C_NCOPY_LABEL 


DWT$C_NHORIZONTAL 


DWT$C_NDECIMAL_POINTS 
DWT$C_NDEFAULT_BUTTON 


DWT$C_NDEFAULT_HORIZONTAL_ 
OFFSET 


DWT$C_NDEFAULT_POSITION 
DWT$C_NDEFAULT_PUSHBUTTON 


DWT$C_NDEFAULT_VERTICAL_ 
OFFSET 


DWT$C_NFONT 
DWT$C_NDIR_MASK 


DWT$C_NDIRECTION_R_TO_L 
DWT$C_NDISMISS_LABEL 


DWT$C_NDISP_WIN_MARGIN 


MIT C Binding Name 


DwtNcacheHelpLibrary 


DwtNcancelButton 
DwtNcancelLabel 


DwtNchangeVisAtts 
DwtNchildOverlap 
DwtNcloseLabel 


DwtNcolorModel 
DwtNcols 
DwtNvalue 


DwtNvalue 


DwtNconformTo Text 
DwtNcopyLabel 


DwtNhorizontal 
DwtNdecimalPoints 


DwtNdefaultButton 
DwtNdefaultHorizontalOffset 


DwtNdefaultPosition 
DwtNdefaultPushbutton 
DwtNdefaultVerticalOffset 


DwtNfont 
DwtNdirMask 


DwtNdirectionRToL 
DwtNdismissLabel 


DwtNdispWinMargin 
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UIL Name 
display_col_ 
win_height 


display_col_ 
win_width 


display_labe! 


display_ window 
edit_label 


editable 
entry_alignment 


entry_border_ 
width 


error_open_ 
message 


exit_label 
file_label 


file_search_ 
proc 


file_selection_ 
value 


file_to_extern_ 
proc 


file_to_intern_ 
proc 


fill_highlight 
filter_label 


first_topic 


font_argument 


foreground_ 
color 


fraction_base 
full_label 


glossary_label 


UIL Data Type 


integer 
integer 


compound_ 
string 


object reference 


compound_ 
string 


boolean 
integer 
integer 


compound_ 
string 


compound_ 
string 


compound_ 
string 


any 


compound_ 
string 


any 
any 


boolean 


compound_ 
string 


compound_ 
string 


font_table 
color 


integer 


compound_ 
string 


compound_ 
string 


VAX Binding Name 


DWT$C_NDISPLAY_COL_WIN_HEIGHT 
DWT$C_NDISPLAY_COL_WIN_WIDTH 
DWT$C_NDISPLAY_LABEL 


DWT$C_NDISPLAY_WINDOW 
DWT$C_NEDIT_LABEL 


DWT$C_NEDITABLE 
DWT$C_NENTRY_ALIGNMENT 
DWT$C_NENTRY_BORDER 


DWT$C_NERROROPEN_MESSAGE 
DWT$C_NEXIT_LABEL 
DWT$C_NFILE_LABEL 
DWT$C_NFILE_SEARCH_PROC 
DWT$C_NVALUE 
DWT$C_NFILE_TO_EXTERN_PROC 
DWT$C_NFILE_TO_INTERN_PROC 


DWT$C_NFILL_HIGHLIGHT 
DWT$C_NFILTER_LABEL 


DWT$C_NFIRST_TOPIC 


DWT$C_NFONT 
DWT$C_NFOREGROUND 


DWT$C_NFRACTION_BASE 
DWT$C_NFULL_LABEL 


DWT$C_NGLOSSARY_LABEL 
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MIT C Binding Name 
DwtNdisplayColWinHeight 


DwtNdisplayColWinWidth 
DwiNdisplayLabel 


DwtNdisplayWindow 


‘DwtNeditLabel 


DwtNeditable 
DwtNentryAlignment 
DwtNentryBorder 


DaiNarocooenMessane 
DwtNexitLabel 
DwtNfileLabel 
DwtNfileSearchProc 
DwtNvalue 


DwtNfileToExternProc 


DwtNfileTolnternProc 


DwtNfillHighlight 
DwiNfilterLabel 


DwtNfirstTopic 


DwtNfont 
DwtNforeground 


DwtNfractionBase 
DwtNfullLabel 


DwiNglossaryLabel 
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Table B-39 (Cont.) UIL Arguments 


UIL Name 


glossary_topic 
go_back_label 
go_over_label 
go_to_label 


gobacktopic_ 
label 


gototopic_label 


grab_merge_ 
translations 


gray_label 
green_label 


half_border 
height 


help_ 
acknowledge_ 
label 


help_font 
help_label 


help_message_ 
title 


help_message_ 
title_type 


help_on_help_ 
title 


helphelp_label 
helpontitle_label 
helptitle_label 
highlight_color 


highlight_ 
pixmap 


UIL Data Type 
compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
String 


compound_ 
string 


compound_ 
string 


translation_ 
table 


compound_ 
string 


compound_ 
string 


boolean 
integer 


compound_ 
string 


font_table 


compound_ 
string 


compound_ 
string 


integer 


compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
string 


color 
pixmap 


VAX Binding Name 
DWT$C_NGLOSSARY_TOPIC 


DWT$C_NGOBACK_LABEL 
DWT$C_NGOOVER_LABEL 
DWT$C_NGOTO_LABEL 
DWT$C_NGOBACKTOPIC_LABEL 
DWT$C_NGOTOTOPIC_LABEL 
DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 
DWT$C_NGRAY_LABEL 


DWT$C_NGREEN_LABEL 


DWT$C_NHALF_BORDER 
DWT$C_NHEIGHT 


DWT$C_NHELP_ACKNOWLEDGE_ 


LABEL 


DWT$C_NHELP_FONT 
DWT$C_NHELP_LABEL 


DWT$C_NHELPMESSAGE_TITLE 
DWT$C_NHELPMESSAGE_TITLE_ 
TYPE 
DWT$C_NHELP_ON_HELP_TITLE 
DWT$C_NHELPHELP_LABEL 
DWT$C_NHELPONTITLE_LABEL 


DWT$C_NHELPTITLE_LABEL 


DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 


MIT C Binding Name 


DwtNglossary Topic 
DwtNgobackLabel 
DwtNgooverLabel 
DwtNgotoLabel 
DwtNgobacktopicLabel 
DwtNgototopicLabel 
DwtNgrabMergeTranslations 
DwtNgrayLabel | 
DwtNgreenLabel 


DwtNhalfBorder 
DwtNheight 
DwtNhelpAcknowledgeLabel 


DwtNhelpFont 
DwtNhelpLabel . 
DwtNhelpmessageTitle 
DwtNhelpmessageTitle Type 
DwtNhelpOnHeipTitle 
DwiNhelphelpLabel 
DwtNhelpontitleLabel 
DwtNhelptitleLabel 


DwiNhighlight 
DwtNhighlightPixmap 
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UIL Name 


history 


history_box_ 
label 


history_label 
his_label 


horizontal_ 
scroll_bar 


hot_spot_ 
pixmap 


hue_label 


icon_pixmap 
indicator 


insensitive_ 
pixmap 


insensitive_ 
pixmap_off 


insensitive _ 
pixmap_on 


insertion_point_ 
visible 
insertion_ 
position 


items 
keyword_label 


keywords_label 


label_alignment 
label_label 


label_label_type 
label_pixmap 
library_spec 


library_type 
light_label 


UIL Data Type 


— String 


compound_ 
string 


compound_ 
string 


compound_ 
string 


object reference 
pixmap 
compound_ 
string 

pixmap 

boolean 

pixmap 


pixmap 
pixmap 


boolean 


~ integer 


string_table 
compound_ 


String 


compound_ 
string 


integer 


compound_ 
string 


integer 
pixmap 


compound_ 
string 


integer 


compound_ 
string — 


VAX Binding Name 


DWT$C_NHISTORY 
DWT$C_NHISTORYBOX_LABEL 


DWT$C_NHISTORY_LABEL 
DWT$C_NHLS_LABEL 
DWT$C_NHORIZONTAL_SCROLL_BAR 
DWT$C_NHOT_SPOT_PIXMAP 
DWT$C_NHUE_LABEL 


DWT$C_NICON_PIXMAP 
DWT$C_NINDICATOR 
DWT$C_NINSENSITIVE_PIXMAP 


DWT$C_NINSENSITIVE_PIXMAP_OFF 
DWT$C_NINSENSITIVE_PIXMAP_ON 
DWT$C_NINSERTION_POINT_VISIBLE 
DWT$C_NINSERTION_POSITION 


DWT$C_NITEMS 
DWT$C_NKEYWORD_LABEL 


DWT$C_NKEYWORDS_LABEL 


DWT$C_NLABEL_ALIGNMENT 
DWT$C_NLABEL 


DWT$C_NLABEL_TYPE 
DWT$C_NPIXMAP 
DWT$C_NLIBRARY_SPEC 


DWT$C_NLIBRARY_TYPE 
DWT$C_NLIGHT_LABEL 
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MIT C Binding Name 


~ DwtNhistory 


DwtNhistoryboxLabel 
DwtNhistoryLabel 
DwtNhisLabel 
DwtNhorizontalScrollBar 
DwtNhotSpotPixmap 
DwtNhueLabel 


DwtNiconPixmap 
DwtNindicator 
DwtNinsensitivePixmap 


DwtNinsensitivePixmapOff 
DwtNinsensitivePixmapOn 
DwtNinsertionPointVisible 
DwtNinsertionPosition 


DwtNitems 
DwtNkeywordLabel 


DwtNkeywordsLabel 


DwtNlabelAlignment 
DwtNiabel 


DwtNlabelType 
DwtNpixmap 
DwtNlibrarySpec 


DwtNlibraryType 
DwtNlightLabel 
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Table B-39 (Cont.) UiL Arguments 


UIL Name 


lines 
list_updated 


main_ 
command_ 
window 


main_ 
horizontal_ 
scroll_bar 


main_label 


main_menu_bar 


main_vertical_ 
scroll_bar 


main_work_ 
window 


mapped_when_ 
managed 


margin_bottom 
margin_height 
margin_left 
margin_right 
margin_top 
margin_width 


mask_to_ 
extern_proc 


mask_to_ 
intern_proc 


match_colors 
max_length 
max_value 


menu_, 
alignment 


menu_entry_ 
class 


menu_extend_ 
last_row 


menu_help_ 
widget 


menu_history 


UIL Data Type 


integer 
boolean 
object reference 


object reference 


compound_ 
string 


object reference 
object reference 


object reference 
boolean 


integer 
integer 
integer 
integer 
integer 
integer 
any 


any 


boolean 
integer 
integer 
boolean 


class_rec_name 
boolean 
object reference 


object reference 


VAX Binding Name 


DWT$C_NLINES 
DWT$C_NLIST_UPDATED 
DWT$C_NCOMMAND_WINDOW 


DWT$C_NHORIZONTAL_SCROLL_BAR 


DWT$C_NMAIN_LABEL 


DWT$C_NMENU_BAR 
DWT$C_NVERTICAL_SCROLL_BAR 


DWT$C_NWORK_WINDOW 
DWT$C_NMAPPED_WHEN_MANAGED 


DWT$C_NMARGIN_BOTTOM 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NMARGIN_LEFT 
DWT$C_NMARGIN_RIGHT 
DWT$C_NMARGIN_TOP 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMASK_TO_EXTERN_PROC 


DWT$C_NMASK_TO_INTERN_PROC 


DWT$C_NMATCH_COLORS 
DWT$C_NMAX_LENGTH 
DWT$C_NMAX_VALUE 
DWT$C_NMENU_ALIGNMENT 


DWT$C_NMENU_ENTRY_CLASS 
DWT$C_NMENU_EXTEND_LAST_ROW 
DWT$C_NMENU_HELP_WIDGET 


DWT$C_NMENU_HISTORY 


MIT C Binding Name 


DwiNlines 
DwtNlistUpdated 
DwtNcommandWindow 


DwtNhorizontalScrollBar 


DwtNmainLabel 


DwtNmenuBar 
DwtNverticalScrollBar 


DwtNworkWindow 
DwtNmappedWhenManaged 


DwtNmarginBottom 
DwtNmarginHeight 
DwtNmarginLeft 
DwtNmarginRight 
DwtNmarginTop 
DwtNmarginWidth 
DwtNmaskToExternProc 


DwtNmaskTolnternProc 


DwtNmatchColors 
DwtNmaxLength 
DwtNmaxValue 
DwitNmenuAlignment 


DwtNmenuEntryClass 
DwtNmenuExtendLastRow 
DwtNmenuHelpWidget 


DwtNmenuhistory 
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UIL Name 
menu_is_ 
homogeneous 


menu_num_ _ 
columns 


menu_packing 
menu_radio 
menu_type 
min_value 
mixer_label 


mixer_window 
must_match 
new_blue_value 


new_disp__ 
window 


new_green_ 
value 


new_red_value 


no_keyword_ 
message 


no_label 


no_resize 


no_title_ 
message 


null_library_ 
message 


null_topic_ 
message 


ok_label 
option_label 


orientation 
orig_blue_value 


orig_disp_ 
window 


orig_green_ 
value 


orig_red_value 


UIL Data Type 


boolean 
integer 


integer 
boolean 
integer 
integer 


compound_ 
string 


object reference 
boolean 

color 

object reference 


color 


color 


compound_ 
string 


compound _ 
string 


boolean 


compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
string 


integer 
color 
object reference 


color 


color 


VAX Binding Name 
DWT$C_NMENU_IS_ HOMOGENEOUS 


DWT$C_NMENU_NUM_COLUMNS 


DWT$C_NMENU_PACKING 
DWT$C_NMENU_RADIO 
DWT$C_NMENU_TYPE 
DWT$C_NMIN_VALUE 
DWT$C_NMIXER_LABEL 


DWT$C_NMIXER_WINDOW 
DWT$C_NMUST_MATCH 
DWT$C_NNEW_BLUE_VALUE 
DWT$C_NNEW_DISP_WINDOW 


DWT$C_NNEW_GREEN_VALUE 


DWT$C_NNEW_RED_VALUE 
DWT$C_NNOKEYWORD_MESSAGE 


DWT$C_NNO_LABEL 


DWT$C_NNO_RESIZE 
DWT$C_NNOTITLE_MESSAGE 


DWT$C_NNULLLIB_MESSAGE 
DWT$C_NNULLTOPIC_MESSAGE 
DWT$C_NOK_LABEL 
DWT$C_NOPTION_LABEL 


DWT$C_NORIENTATION 
DWT$C_NORIG_BLUE_VALUE 
DWT$C_NORIG_DISP_WINDOW 


DWT$C_NORIG_GREEN_VALUE 


DWT$C_NORIG_RED_VALUE 
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MIT C Binding Name 


DwiNmenulsHomogeneous 
DwtNmenuNumColumns 


DwtNmenuPacking 
DwtNmenuRadio 
DwtNmenuType 
DwtNminValue 
DwtNmixerLabel 


DwtNmixerWindow 
DwtNmustMatch 
DwtNnewBlueValue 
DwtNnewDispWindow 


DwtNnewGreenValue 


DwtNnewRedValue 
DwtNnokeywordMessage 


DwiNnoLabel 


DwtNnoResize 
DwtNnotitleMessage 


DwtNnulllibMessage 
DwtNnulltopicMessage 
DwtNokLabel 
DwtNoptionLabel 


DwtNorientation 
DwtNorigBlueValue 
DwtNorigDispWindow 


DwtNorigGreenValue 


DwtNorigRedValue 
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UIL Data Type VAX Binding Name 


UIL Name 


overview_topic 


pending_delete 
pixmap_off 
pixmap_on 
prompt 


radio_always __ 
one 


red_label 
reset_label 


resizable 
resize 
resize_height 
resize_mode 
resize_width 
rgb_label 


rows 


rubber_ 
positioning 


sat_label 
save_as_label 


scale_height 
scale_value 
scale_width 
scroll_bar_inc - 


scroll_bar_ 
page_inc 


scroll_bar_value 
scroll_horizontal 
scroll_left_side 
scroll_top_side 
scroll_vertical 


compound_ 
string 


boolean 
pixmap 
pixmap 


compound_ - 


string 
boolean — 


compound_ 
string 


compound_ 
string 


boolean. 
integer 
boolean 
integer 
boolean 


compound_ 
string 


integer 
boolean 


compound_ 
string 


compound_ 
string 


integer 
integer 
integer. 
integer 
integer 


integer 

boolean 
boolean 
boolean 
boolean 


DWT$C_NOVERVIEW_TOPIC 


DWT$C_NPENDING_DELETE 
DWT$C_NPIXMAP_OFF 
DWT$C_NPIXMAP_ON 
DWT$C_NPROMPT 


~ DWT$C_NRADIO_ALWAYS_ONE 


DWT$C_NRED_LABEL 


DWT$C_NRESET_LABEL 


DWT$C_NRESIZABLE 


DWTS$C_NRESIZE 


DWT$C_NRESIZE_HEIGHT 
DWT$C_NRESIZE 
DWT$C_NRESIZE_WIDTH 
DWT$C_NRGB_LABEL 


DWT$C_NROWS 


DWT$C_NRUBBER_POSITIONING 


DWT$C_NSAT_LABEL 
DWT$C_NSAVEAS_LABEL 


DWT$C_NSCALE_HEIGHT 
DWT$C_NVALUE 
DWT$C_NSCALE_WIDTH 
DWT$C_NINC 
DWT$C_NPAGE_INC 


DWT$C_NVALUE 
DWT$C_NSCROLL_HORIZONTAL 
DWT$C_NSCROLL_LEFT_SIDE 
DWT$C_NSCROLL_TOP_SIDE 
DWT$C_NSCROLL_VERTICAL 


. MIT C Binding Name 


DwtNoverviewTopic | 


DwtNpendingDelete | 
DwtNpixmapOff 
DwtNpixmapOn 


DwtNprompt 


DwtNradioAlwaysOne 
DwtNredLabel 
DwitNresetLabel 


DwtNresizable 
DwtNresize 
DwtNresizeHeight 
DwitNresize 
DwtNresizeWidth 


- DwtNrgbLabel 


DwtNrows 
DwtNrubberPositioning 


DwtNsatLabel 
DwtNsaveasLabel 


DwtNscaleHeight 
DwtNvalue 
DwiNscaleWidth 
DwtNine 
DwtNpageinc 


DwtNvalue 
DwtNscrollHorizontal 
DwiNscrollLeftSide 
DwtNscrollTopSide 
DwtNscrollVertical 
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UIL Name 
search_apply_- 
label 


search_~— 
keyword_ 
box_label 


search_label 


search_title_ 
box_label 


second_label 


second_label__ 
alignment 


select_all_label 


selected_items 
selection_label 


selection_value 


sensitive 


set_new_color_ . 


shape 
show_arrows 
show_value 


show_value_ 
automatic 


shown 


shown_value_ 
automatic_horiz 


shown. value__ 
automatic_vert 


simple_text_ 
value 


single_selection 
slider_color 
slider_label 


VIL Data Type 


compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
string 


compound_ 
string 


integer 


compound_ 


— String 


string_table | 


compound_ 
string 


compound_ 
string 


boolean 
any 


boolean 
integer 

boolean 
boolean 
boolean 


integer 
boolean 


boolean 
string 


boolean 
color 


compound_ 
string 


VAX Binding Name 


- DWT$C_NSEARCHAPPLY_LABEL 


DWT$C_NSEARCHKEYWORDBOX_ 
LABEL . 


DWTS$C_NSEARCH_LABEL 
DWT$C_NSEARCHTITLEBOX_LABEL 
DWT$C_NSECOND_LABEL 
DWTS$C_NSECOND_LABEL_ 
ALIGNMENT 
DWT$C_NSELECTALL_LABEL 


DWT$C_NSELECTED_ ITEMS 


DWT$C_NSELECTION_LABEL 


DWT$C_NVALUE 


DWT$C_NSENSITIVE 
DWT$C_NSET_NEW_COLOR_PROC 


DWT$C_NSHADOW 
DWT$C_NSHAPE 
DWT$C_NSHOW_ARROWS 
DWT$C_NSHOW_VALUE 


DWT$C_NSHOW_VALUE_AUTOMATIC 


DWT$C_NSHOWN 


DWT$C_NSHOWN_VALUE_ 
AUTOMATIC_HORIZ 


DWT$C_NSHOWN_VALUE _ 
AUTOMATIC_VERT 


DWT$C_NVALUE 


DWT$C_NSINGLE_SELECTION 
DWT$C_NSLIDER 
DWT$C_NSLIDER_LABEL 
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MIT C Binding Name 


DwtNsearchapplyLabel 


DwtNsearchkeywordboxLabel 


DwtNsearchLabel 


_ DwtNsearchtitleboxLabel 


DwtNsecondLabel 
DwtNsecondLabelAlignment 
DwtNselectallLabel 


DwtNselecteditems 
DwtNselectionLabel 


DwtNvalue 


DwtNsensitive 
DwtNsetNewColorProc 


DwtNshadow 

DwtNshape 
DwtNshowArrows 
DwtNshowValue 
DwtNshowValueAutomatic 


DwtNshown 
DwtNshownValueAutomaticHoriz 


DwtNshownValueAutomaticVert 
DwtNvalue 


DwtNsingleSelection 
DwitNslider 
DwtNsliderLabel 
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UIL Name. 


slider_pixmap 
spacing 

style 
take_focus 
text_cols 


text_merge_ 
translations 


text_translation 
title 

title_label 

titles label 


toggle_value 
top_position 


topic_titles_ 
label 


translations 


units 
user_data 
value_label 


vertical_scroll_ 
bar 


view_label 


visible_items_ 
count 


visible_when_ 
off 


visit_glossary_ 
label 


visit_label 


visittopic_label 


UIL Data Type 


pixmap 
integer 
integer 
boolean 
integer 


translation_ 
table 


translation_ 
table 


compound_ 
string 


compound_ 
string 


compound_ 
string 


boolean 
integer 


compound_ 
string 


translation 
table 


integer 
any 


compound_ 
string 


object reference 


compound_ 
string 


integer 
boolean 


compound_ 
string 


compound_ 
string 


compound_ 
string 


VAX Binding Name 


DWT$C_NSLIDER_PIXMAP 
DWT$C_NSPACING 
DWT$C_NSTYLE 
DWT$C_NTAKE_FOCUS 
DWT$C_NTEXT_COLS 
DWT$C_NTEXT_MERGE_ 


TRANSLATIONS 
DWT$C_NT_TRANSLATION 
DWT$C_NTITLE 
DWT$C_NTITLE_LABEL 
DWT$C_NTITLES_LABEL 


DWT$C_NVALUE 
DWT$C_NTOP_POSITION 
DWT$C_NTOPICTITLES_LABEL 


DWT$C_NTRANSLATIONS 


DWT$C_NUNITS 
DWT$C_NUSER_DATA 
DWT$C_NVALUE- LABEL 


DWT$C_NVERTICAL_SCROLL_BAR 
DWT$C_NVIEW_LABEL 
DWT$C_NVISIBLE_ITEMS_COUNT 
DWT$C_NVISIBLE_WHEN_OFF 
DWT$C_NVISITGLOS_LABEL 
DWT$C_NVISIT_LABEL 


DWT$C_NVISITTOPIC_LABEL 


MIT C Binding Name 


DwtNsliderPixmap 
DwtNspacing 

DwtNstyle 

DwitNtakeFocus 
DwtNtextCols 
DwtNtextMergeTransiations 


DwiNtTranslation 
DwiNtitle | 
DwitNtitleLabel 
DwtNtitlesLabel 


DwtNvalue 
DwtNtopPosition 
DwtNtopictitlesLabel 


DwtNtranslations 


DwtNunits 
DwtNuserData 
DwtNvalueLabel 


DwtNverticalScrollBar 
DwtNviewLabel 
DwtNvisibleltemsCount 
DwtNvisiblewhenOff 
DwtNvisitglosLabel 
DwtNvisitLabel 


DwtNvisittopicLabel 
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Table B-39 (Cont.) UIL Arguments 


UIL Name 


white_label 


widget_direction 
width 
word_wrap 
work_window 

x 


y 
yes_label 


UIL Data Type 
compound_ 
string 

integer 

integer 

boolean 

object reference 
integer 

integer 


compound_ 
string 


VAX Binding Name 
DWT$C_NWHITE_LABEL 
DWT$C_NDIRECTION_R_TO_L 


DWT$C_NWIDTH 
DWT$C_NWORD_WRAP 


‘DWT$C_NWORK_WINDOW 


DWT$C_NX 
DWT$C_NY 


DWT$C_NYES_LABEL 


UIL Built-In Tables 
B.38 UIL Arguments 


MIT C Binding Name 


DwtNwhiteLabel 


DwtNdirectionRToL 
DwtNwidth 
DwtNwordWrap 
DwtNworkWindow 
DwtNx 

DwtNy 
DwtNyesLabel 


index 





A 


Addition (+) operator * 2-32 
ANY data type * 2-30 
ANY value » 2-30 
Argument 
constraint * 3-20 
coupled « 3~10 
specifying * 3-15 
symbolic reference to widget identifier » 3-21 
using arguments list to specify » 3-10 
using multiple arguments lists to specify «3-14 
ARGUMENT function » 2-26, 3-10 
Argument name 
user-defined * 2-26 
ARGUMENTS keyword « 3-10 
Arguments list * 3-10 
using multiple * 3—14 
Arguments list declaration » 3-10 
Arguments list structure * 3-10 
Argument values 
types * 2-26 
user-defined * 2—26 
ASCIZ_STRING_TABLE function * 2-24 to 2-25 


Background color 

defining for icon * 2-18 

designating » 2-16 
Bitwise AND operator * 2-33 
Bitwise OR operator * 2-33 
Bitwise XOR operator * 2-33 
Boolean literal values » 2-15 
Built-in tables * B—1 


C 


Callback procedure 

passing data structure to * 3-19 
Callbacks 

specifying » 3-15 








Callbacks (Cont.) 


using Callbacks list to specify * 3-11 

using multiple callbacks lists to specify » 3-14 
CALLBACKS keyword « 3-11 
Callbacks list * 3-11 

using multiple * 3-14 
Callbacks list declaration * 3-11 
Callbacks list structure * 3~11 
Callback tag + 3-7 
Case-sensitive mode > 

keywords ¢ 2-3 

names ¢ 2-3 
Case-sensitivity clause * 3-3 
CASE_INSENSITIVE keyword « 3-3 
CASE_SENSITIVE keyword « 3-3 
Character set 

See also Default character set 

for language * 2-1 

for string literal values * 2-10 

non-Latin * 2-10 

parsing rules for » 2—11 
CHARACTER_SET keyword « 3-3 
Children 

See also Controls 

specifying * 3-15 

using controls list to specify » 3-13 

using multiple controls lists to specify * 3-14 
CLASS_REC_NAME function ¢ 2-22 
COLOR function 2-16 to 2-19 
Color map * 2-17 
Color table * 2-18 

See also Default color table 
Color table values * 2-18 

defining colors for * 2-16 
Color values * 2—16 

defining monochrome mapping for * 2-17 

server name ¢ 2-17 
COLOR_TABLE function * 2-18 
Comments 

punctuation for * 2—2 
Compiler 

command qualifiers * 4—1 

DCL command « 4-1 

diagnostics * 4-3 

error severity levels * 4—4 

invoking * 4—1 

suppressing data type checking * 2-30 


Index—1 


Index 


Compiler command « 4-1 
Compiler listing * 4-1, 4—4 
interpreting diagnostics on * 4-6 
interpreting source line on * 4-5 
interpreting summaries on « 4—6 
interpreting title on * 4—5 
suppressing warning and informational messages 
4-2 


Compile-time expressions ¢ 2~31 
Compound strings, multiline * 2-23 
Compound string values * 2—22 
COMPOUND_STRING function » 2-22 
COMPOUND_STRING_TABLE function » 2-24 
Concatenation operator (&) * 2-13, 2-32 
Constants 

include file » 2-31 
Constraint arguments « 3-20 

See also Children 
Controls 

specifying «3-15 
CONTROLS keyword ¢ 3-13 
Controls list » 3-13 

using multiple «3-14 
Controls list declaration * 3-14 
Controls list structure * 3-13 
Coupled arguments * 3-10 


D 


Data type 

See Values 
Data type conversion * 2-33 

automatic * 2-34 

listing of functions * 2-34 
DECW$RGB.COM command procedure * 2—17 
DEC_HANZI character set » 2—11 
DEC_KANJI character set * 2-11 
DEC_TECH character set 2—11 
Default character set 

for compound string * 2-7 

for FONT function * 2-21 

for module « 3-3 

for null-terminated string * 2—7 
Default character set clause * 3-3 
Default color table * 2-20 
Default object variant 

for module * 3-3, 3-16 . 
Default object variant clause * 3-3, 3-16 
Diagnostic messages * A-1 to A-11 
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Diagnostics * 4~3 
Division (/) operator * 2-32 
DRM (XU! Resource Manager) 
REGISTER DRM NAMES routine * 3-12 


E 


END keyword « 3-1 

Error detection * 1-2 

Escape sequences * 2-7 
EXPORTED keyword « 3-4, 3-14 
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Floating-point literal values «2-15 
FONT function * 2-20 

Font table values ¢ 2-21 

Font values * 2-20 

FONT_TABLE function * 2-21 


_ Foreground color 


defining for icon * 2-18 
designating * 2-16 
Form-feed character * 2~2 
Functions 
ARGUMENT ° 2-26, 3-10 
ASCIZ_STRING_TABLE * 2-24 
CLASS_REC_NAME « 2-22 
COLOR ¢ 2-16 
COLOR_TABLE ¢ 2-18 
COMPOUND_STRING « 2-22 
COMPOUND_STRING_TABLE ¢ 2-24 
data type conversion * 2-34 
FONT * 2—20 
FONT_TABLE ¢ 2-21 
ICON * 2-19 
INTEGER_TABLE « 2~25 
REASON ¢ 2-28, 3-11 
TRANSLATION_TABLE ¢ 2-29 


G 


Gadget 
declaring * 3-15 
specifying » 3-14 
specifying in objects clause * 3-3, 3-16 
specifying variant in object declaration * 3-16 








Gadget declaration * 3—14, 3-16 
GADGET keyword « 3-3, 3-14, 3-16 
Global reference »* 3-4 


AH 
Help 


invoking * 4—3 
HELP UIL command « 4-3 


Icon 

defining colors for * 2-16 
ICON function * 2-19 
Icon values * 2-18 
Identifiers * 3-17 
Identifier section structure * 3-17 
IMPORTED keyword « 3—4, 3—14 
Include directive » 3-19 
Include file 

MIT C binding * 3-12, 3-20 

VAX binding * 3-12, 3-20 
Include file for constants 

MIT C binding ¢ 2-31 

VAX binding * 2-31 
INCLUDE FILE keyword « 3-19 
Integer literals 

data storage * 2-14 
Integer literal values * 2-14 
INTEGER_TABLE function * 2-25 
Interface customization * 1-3 
ISO_ARABIC character set * 2—11 
ISO_GREEK character set * 2—11 
ISO_HEBREW character set + 2-11 
ISO_HEBREW_LR character set * 2—11 
ISO_LATIN1 character set * 2-11 
ISO_LATIN2 character set * 2-11 
ISO_LATIN3 character set «2-11 
ISO_LATIN4 character set + 2-11 
ISO_LATIN8 character set * 2-11 
ISO_LATIN8_LR character set * 2-11 


J 


JIS_KATAKANA character set * 2-11 
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K 


Keywords « 2-3 
ARGUMENTS « 3-10 
CALLBACKS « 3—11 
case sensitivity of «2-3 
CASE_INSENSITIVE « 3-3 
CASE_SENSITIVE «3-3 
CHARACTER_SET ¢ 3-3 
CONTROLS ¢ 3-13 
END + 3-1 
EXPORTED * 3-4, 3-14 
GADGET ¢ 3-3, 3-14, 3-16 
IMPORTED ¢ 3-4, 3-14 
INCLUDE FILE + 3-19 
LIST + 3-9 
MANAGED « 3-13 
MODULE ¢ 3-1 
NAMES °¢ 3-3 
OBJECT «3-14 
OBJECTS * 3-3, 3-16 
PRIVATE ¢ 3-4, 3-14 
PROCEDURE «3-7, 3-11 
UNMANAGED « 3-13 
VALUE « 3-5 

- VERSION + 3-2 | 
WIDGET + 3-14, 3-16 


L 


LIST keyword * 3-9 
/LIST qualifier » 4—1 
List section structure * 3-9 
List type * 3-9 
arguments * 3-10 
callbacks * 3-11 
controls * 3-13 
Literal values * 2-6 
Local reference «3-4 
Logical names 
for colors * 2-17 


/MACHINE_CODE qualifier » 4-2 
MANAGED keyword « 3-13 
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Index 


Mapping colors to monochrome display * 2-17 
MIT C binding include file * 2-31 
Module 
ANY values * 2-30 
arguments list «3-10 
arguments list declaration » 3-10 
argument values * 2-26 
Boolean literal values * 2-15 
class record names * 2-22 
color table values * 2-18 
color values * 2-16 
compile-time expressions * 2-31 
compound strings * 2-22 
concatenation operator * 2-13 
controls list * 3-13 
data type conversion * 2-33 
defining monochrome mapping for colors * 2—17 
escape sequences ¢ 2—7 
floating-point literal values * 2-15 
font table values * 2-21 
font values * 2-20 
functions * 2-16 
gadget declaration » 3-14 
icon values * 2-18 
identifiers * 3-17 
include directive «3-19 
including case-sensitivity clause * 3-3 
including default character set clause * 3-3 
including objects clause + 3-3, 3-16 
including version clause * 3—2 
integer literal values * 2-14 
keywords * 2-3 
list section * 3-9 
list types * 3-9 
literal values * 2-6 
names * 2-3 
non-Latin character sets * 2-10 
object declaration » 3-14 
object section » 3-14 
operators * 2-31 
parsing rules for non-Latin character set + 2—11 
pixmap values * 2-18 
privacy of references in» 3-4 
procedure declaration * 3-7 
procedure section * 3~7 
punctuation characters * 2-2 
reason values * 2—28 
reserved keywords « 2-3 
specifying non-Latin character sets in * 2-10 
String literal values * 2-7 
string table values * 2-24 
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Module (Cont.) 
structure of « 3—1 
symbolic references to widget identifiers » 3-21 
text formatting characters and comments * 2-2 
translation table values * 2-29 
value declaration * 3-5 
value section * 3-5 
widget declaration * 3-14 

Module header 
including case-sensitivity clause * 3-3 
including default character set clause * 3-3 
including objects clause * 3-3, 3-16 
including version clause * 3~2 

MODULE keyword « 3-1 

Monochrome display 
mapping colors for «2-17 

Multiline compound strings * 2-23 

Multiplication (*) operator « 2-32 


N 


Names ¢ 2-3 
case sensitivity of * 2-3 
NAMES keyword « 3-3 
Negative (—) operator * 2-32 
Non-Latin character set 
DEC_HANZI « 2-11 
DEC_HEBREW - 2-11 
DEC_KANuJI + 2-11 
DEC_TECH « 2-11 
ISO_ARABIC « 2-11 
ISO_GREEK « 2-11 
ISO_HEBREW « 2-11 
ISO_HEBREW.LR ¢ 2-11 
ISO_LATIN( * 2-11 
ISO_LATIN2 * 2-14 
ISO_LATINS « 2-11 
ISO_LATIN4 * 2-11 
ISO_LATIN8 « 2-11 
ISO_LATIN8_LR + 2-11 
JIS_KATAKANA ° 2-11 
parsing rules for «2-11 
Non-Latin character sets * 2-10 
No-op (+) operator * 2-32 
NOT (~) operator * 2-32 
Null-terminated string 
default character set * 2-7 
Null-terminated string values * 2-22 
concatenation operator * 2-13 








O 


Object 
declaring * 3-15 
specifying * 3-14 
specifying default variant for module « 3-3 
specifying global reference » 3—4 
_ specifying local reference * 3—4 
specifying multiple lists for * 3-14 
specifying variant in object declaration * 3-16 
specifying variant type * 3-16 
symbolic references to + 3—21 
Object declaration «3-14, 3-16 
OBJECT keyword « 3-14 
Object reference * 3-21 
Object resource 
specifying scope for * 3-4 
Objects clause * 3-3 
Object scope + 3-4 
Object section 
declaring gadgets in * 3-16 
specifying multiple lists in * 3-14 
Object section structure * 3-14 
OBJECTS keyword « 3-3, 3-16 
Online help * 4-3 
Operators 
* (Binary) ¢ 2-32 
/ (Binary) «2-32 
+ (Binary) * 2-32 
>> (Binary) * 2-32 
<< (Binary) * 2-32 
& (Binary) * 2~32 
| (Binary) * 2-32 
4 (Binary) * 2-32 
concatenation * 2-13 
data type conversion * 2-33 
in compile-time expressions + 2-31 
~ (Unary) * 2-32 
— (Unary) * 2~32 
+ (Unary) * 2~32 
/OUTPUT qualifier » 4—2 
Overview of UIL ° 1-1 


p 


Parsing rules for non-Latin character set * 2—11 
Pixmap 
See Icon 








Index 


Pixmap (Cont.) 

functions for specifying » 2-18 
Privacy 

of data in module « 3-4 

of list names * 3-9 
PRIVATE keyword « 3-4, 3-14 
Procedure 

declaring * 3-7, 3-8 
Procedure declaration * 3-7 

specifying a callback tag * 3-7 
PROCEDURE keyword « 3-7, 3-11 
Procedure section structure * 3-7 
Punctuation characters * 2-2 


R 


REASON function «2-28, 3-11 
Reason name 
user-defined * 2-28 
Reason values * 2—28 
REGISTER DRM NAMES routine » 3-12 
Registration 
of names for DRM « 3-12 
Reserved keywords 
list of * 2-3 
Resources 
scope of reference to * 3-4 
Run-time data 
specifying at compilation time * 3-17 


S 


Shift left (<<) operator * 2-32 
Shift right (>>) operator * 2-32 
Spaces 

using as delimiter * 2—2 
Specification file «2-1 

See also Module 
String literal 

data storage consumption * 2-13 

default character set for * 2—7, 2-13 
String literal values * 2—7 
Strings 

escape sequences for * 2-7 
String table values * 2-24 
Subtraction (-) operator * 2-32 
Symbolic references 

to widget identifiers * 3-21 
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Tab 

using as delimiter «2-2 
Tables, built-in * B—1 
Text formatting characters * 2-2 
Translation table 

directives * 2-29 

syntax * 2-29 

values * 2-29 
Translation table management « 2-29 
TRANSLATION_TABLE function « 2—29 


UID (User Interface Definition) file » 3—1 
color names in «2-17 
compiler listing of UID file records * 4—2 
contrasted with object module « 3-12 
effect of case sensitivity on * 3-3 
floating-point literals in «2-15 
integer literals in * 2-14 
module name * 3—2 
privacy of list names in «3-9 
scope of references in *3—4 
storing object definitions in * 3-14 
suppressing output of * 4-2 
user-defined argument names in * 2-26 
user-defined reason names in * 2-28 

UID file » 1-3 

UID hierarchy + 1-3 

UIL built-in tables » B—1 

UIL command « 4—1 

UIL command qualifiers 
listing of * 4—1 
/LIST qualifier * 4—1 
/MACHINE_CODE qualifier » 4-2 
/OUTPUT qualifier » 4-2 
WARNINGS qualifier * 4—2 

UIL module 
See Module 

UIL specification file 
See Module 

UIL values 
See Values 

UNMANAGED keyword « 3-13 

User-defined widget 
declaring an instance of «3-15 








index—6 


User-defined widget (Cont.) 
specifying arguments for * 2-26 
specifying callback reasons for * 2-28 
specifying callbacks for * 3-11 
specifying creation routine for * 3-8 

User interface object specification 
in object declaration * 3-16 

Value declaration « 3-5 

VALUE keyword « 3-5 

Values 
ANY « 2-30 
argument * 2—26 
Boolean literal * 2—15 
color * 2-16 
color table * 2-18 
compound string * 2-22 
declaring * 3-5, 3-6 
defining mapping for colors * 2-17 
floating-point literal * 2-15 
font * 2-20 
font table » 2-21 
icon * 2-18 
integer literal * 2-14 
listing of types * 3-5 
literal «2-6 
null-terminated string « 2-22 
pixmap * 2-18 
reason * 2-28 
specifying global reference * 3-4 
specifying local reference * 3-4 
String literal « 2-7 
string table «2-24 
translation table * 2-29 

Value scope * 3-4 

Value section structure * 3-5 

VAX binding include file * 2-31 

Version clause * 3-2 

VERSION keyword « 3-2 


W 


WARNINGS qualifier » 4-2 
Widget 

See Object 
Widget declarations 3-14 . 








Widget declaration (Cont.) 

See Object declaration 
Widget hierarchy 

using controls list to specify * 3-13 
Widget identifiers * 3-21 
WIDGET keyword * 3-14, 3-16 
Widget resource 

See Object resource 
Window background color 

See Background color 
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Window foreground color 
See Foreground color 


X 


XDEFAULTS.DAT file * 2~17 
XUI Resource Manager 


See DRM 
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How to Order Additional Documentation 





Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location Call 


Continental USA, 800-DIGITAL 
Alaska, or Hawaii 


Puerto Rico 809-754-7575 
Canada 800-267-6215 
International 

Internal! 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local Digital subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A 


Local Digital subsidiary or 
approved distributor 


USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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